Request history API

The team's past API requests, newest first: endpoint, status, credits charged and time.

GET /v1/account/usage

The team's past API requests, newest first: endpoint, status, credits charged and time. Free. The cursor is the page number (at most 100 pages).

Cost: Free
Cache: Not cached.

Parameters#

Name	Type	Required	Description
`endpoint`	string	no	Only requests whose path contains this text, "/v1/tiktok/profile".
`status`	integer	no	Only requests that answered this HTTP status. Also accepted as `statusCode`, `status_code`.

Every request also accepts:

cursor: the cursor from the previous page (Pagination).

Example request#

Set your key in the environment first (see Authentication).

1curl "https://api.socialscrape.dev/v1/account/usage" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY"

1import os2import requests34res = requests.get(5    "https://api.socialscrape.dev/v1/account/usage",6    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},7)8body = res.json()910if body["ok"]:11    print(body["data"])12else:13    print(body["error"]["code"], body["error"]["message"])

1const res = await fetch("https://api.socialscrape.dev/v1/account/usage", {2  headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },3});4const body = await res.json();56if (body.ok) {7  console.log(body.data);8} else {9  console.error(body.error.code, body.error.message);10}

1{2  "nodes": [3    {4      "name": "SocialScrape Request history",5      "type": "n8n-nodes-base.httpRequest",6      "typeVersion": 4.2,7      "position": [8        0,9        010      ],11      "parameters": {12        "method": "GET",13        "url": "https://api.socialscrape.dev/v1/account/usage",14        "sendQuery": false,15        "sendHeaders": true,16        "headerParameters": {17          "parameters": [18            {19              "name": "x-api-key",20              "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"21            }22          ]23        }24      }25    }26  ],27  "connections": {}28}

Example response#

This is a sample with illustrative values. Status 200.

200 OKSample response

1{2  "ok": true,3  "credits_charged": 0,4  "credits_remaining": 5000,5  "cached": false,6  "cached_at": null,7  "request_id": "req_f0316b94d18d799b109188e6",8  "data": {9    "object": "list",10    "items": [11      {12        "object": "request_log",13        "request_id": "req_0123456789abcdef01234567",14        "endpoint": "/v1/github/user",15        "endpoint_id": "github.user",16        "status": 200,17        "credits_charged": 1,18        "cached": false,19        "created_at": "2026-10-29T14:03:11Z"20      },21      {22        "object": "request_log",23        "request_id": "req_89abcdef0123456789abcdef",24        "endpoint": "/v1/github/user",25        "endpoint_id": "github.user",26        "status": 200,27        "credits_charged": 0,28        "cached": true,29        "created_at": "2026-10-29T14:02:40Z"30      }31    ],32    "cursor": "2",33    "has_more": true34  },35  "cursor": "2",36  "has_more": true37}

Response#

A list of RequestLogEntry objects in data.items, with data.cursor and data.has_more.

See Data models for every field. The envelope around data is described in Responses.

Errors#

Failures are free: credits_charged is 0. Branch on error.code, never on the message.

Code	HTTP	Retry	Meaning
`invalid_params`	400	no	A parameter is missing, unknown or has the wrong type.

Every request can also fail with the account and platform errors listed on the Errors page.

Also served at#

These paths answer the same request, so code written for other APIs keeps working: /v1/account/get-api-usage. See Switching from ScrapeCreators.

Credit balance (GET /v1/account/credits)
Daily usage (GET /v1/account/usage/daily)
Most used endpoints (GET /v1/account/usage/routes)