Most used routes

GET/v1/account/get-most-used-routes0 credits

Your 20 most called endpoints with call counts and credits used, for the last 24 hours or a range you choose.

01Query parameters

Name	Type	Description
start_timeoptional	string	Range start, ISO 8601 (a date alone works). Alone: from then until now.
end_timeoptional	string	Range end, ISO 8601. Alone: the 24 hours before it. A range may span at most one year.

02Request

curl "https://api.scrapesocial.ai/v1/account/get-most-used-routes?start_time=2026-10-01&end_time=2026-10-25" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

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

GET /v1/account/get-most-used-routes?start_time=2026-10-01&end_time=2026-10-25

[
  {
    "base_endpoint": "/v1/pinterest/board",
    "call_count": "10",
    "total_credits": "10"
  },
  {
    "base_endpoint": "/v1/twitter/search/posts",
    "call_count": "9",
    "total_credits": "9"
  }
]

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: `base_endpoint`, `call_count`, `total_credits` (strings), most calls first. Both ends are inclusive; a date alone as `end_time` covers that whole day (UTC). History is kept for 90 days, so a longer range only counts those days. A reversed, unparsable or over-a-year range 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.