Request history

GET/v1/account/get-api-usage0 credits

Your own API requests, newest first, 50 a page: the endpoint called with its query, status code, credits used, duration and times. Filter by endpoint and status code; useful for debugging and monitoring.

01Query parameters

Name	Type	Description
pageoptional	integer	Page number, 1 to 100.Default: `1`
endpointoptional	string	Only requests whose path and query contain this text, e.g. `/v1/tiktok/profile`.
statusCodeoptional	integer	Only requests that answered this HTTP status, e.g. `404`.

02Request

curl "https://api.scrapesocial.ai/v1/account/get-api-usage?page=1&endpoint=%2Fv1%2Finstagram" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/account/get-api-usage?page=1&endpoint=/v1/cosmos

[
  {
    "id": "00000000-0000-0000-0000-000000000540",
    "endpoint": "/v1/cosmos/search?query=architecture&cursor=null",
    "status_code": 200,
    "duration_ms": 5,
    "success": true,
    "response_time": "2026-10-25T17:08:27.169+00:00",
    "request_time": "2026-10-25T17:08:27.164+00:00",
    "request_payload": {
      "query": "architecture",
      "cursor": "null"
    },
    "http_method": "GET",
    "created_at": "2026-10-25T17:08:27.169901+00:00",
    "duration_secs": 0,
    "credits": 0
  },
  {
    "id": "00000000-0000-0000-0000-00000000053f",
    "endpoint": "/v1/cosmos/search?query=architecture&cursor=cursor%3A%2F%2Frecsys%2Fsearch%3Fuser_id%3D0%26profile%3Dsearch__dual70_nouser_recql%26query%3Darchitecture%26last%3D39%26count%3D500",
    "status_code": 200,
    "duration_ms": 394,
    "success": true,
    "response_time": "2026-10-25T17:08:26.728+00:00",
    "request_time": "2026-10-25T17:08:26.334+00:00",
    "request_payload": {
      "query": "architecture",
      "cursor": "cursor://recsys/search?user_id=0&profile=search__dual70_nouser_recql&query=architecture&last=39&count=500"
    },
    "http_method": "GET",
    "created_at": "2026-10-25T17:08:26.728427+00:00",
    "duration_secs": 0,
    "credits": 1
  }
]

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Free and not itself logged. The answer is a JSON array (no envelope). We keep request history for 90 days, so older requests are not listed. A bad `page` or `statusCode` is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.