Daily usage

GET/v1/account/get-daily-usage-count0 credits

Credits used and number of requests per day (UTC) for the last 30 days; days without requests are left out.

01Query parameters

This endpoint takes no parameters.

02Request

curl "https://api.scrapesocial.ai/v1/account/get-daily-usage-count" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/account/get-daily-usage-count

[
  {
    "usage_date": "2026-10-25T00:00:00.000Z",
    "total_credits": "412",
    "request_count": "562"
  },
  {
    "usage_date": "2026-10-21T00:00:00.000Z",
    "total_credits": "958",
    "request_count": "991"
  }
]

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. A JSON array, newest day first: `usage_date`, `total_credits`, `request_count` (counts as strings, like ScrapeCreators).

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.