Daily usage API

Requests and credits charged per day for the last 30 days.

GET /v1/account/usage/daily

Requests and credits charged per day for the last 30 days. Free.

Cost: Free
Cache: Not cached.

Parameters#

This endpoint takes no parameters of its own.

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/daily" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY"

1import os2import requests34res = requests.get(5    "https://api.socialscrape.dev/v1/account/usage/daily",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/daily", {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 Daily usage",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/daily",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_2b2adb48322e8b14374eabe9",8  "data": {9    "object": "list",10    "items": [11      {12        "object": "usage_stat",13        "date": "2026-10-29",14        "endpoint": null,15        "requests": 120,16        "credits_charged": 9517      },18      {19        "object": "usage_stat",20        "date": "2026-10-28",21        "endpoint": null,22        "requests": 84,23        "credits_charged": 7024      }25    ],26    "cursor": null,27    "has_more": false28  },29  "cursor": null,30  "has_more": false31}

Response#

A list of UsageStat 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

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-daily-usage-count. See Switching from ScrapeCreators.

Credit balance (GET /v1/account/credits)
Request history (GET /v1/account/usage)
Most used endpoints (GET /v1/account/usage/routes)