ebaysoldlistingsDOCS

Account and status

Check your plan and remaining monthly allowance with GET /account/usage, and the service health with GET /status.

Usage

Check your plan and how much of your monthly allowance is left. Checking usage is free.

GET/account/usagecost free
Response
{
  "plan": "growth",
  "quota": 15000,
  "used": 4200,
  "remaining": 10800,
  "ratePerMinute": 60,
  "periodEnd": "2026-11-01T00:00:00.000Z"
}

quota and remaining are null on the Unlimited plan.

Request history

List your own requests from the last 30 days, newest first: endpoint, keyword, marketplace, outcome, status code, the error code of failed requests, rows returned and whether it was charged. Failed requests are never charged. Checking history is free and needs an API key.

GET/account/requests?status=failed&limit=20cost free
Response
{
  "windowDays": 30,
  "count": 20,
  "nextBefore": "2026-11-08T17:41:02.118Z",
  "items": [
    {
      "createdAt": "2026-11-09T02:26:56.410Z",
      "endpoint": "/scrape",
      "outcome": "failed",
      "statusCode": 502,
      "error": "upstream_error",
      "keyword": "sony wh-1000xm5",
      "ebaySite": "ebay.com",
      "itemCount": null,
      "cached": null,
      "charged": false,
      "durationMs": null
    }
  ]
}

limit is 1 to 100 (default 50), status is all, success or failed, and before takes the nextBefore value of the previous page.

Status

Public health check, no key needed, for your own monitoring.

GET/statuscost free, no key
Response
{ "status": "ok", "checkedAt": "2026-10-21T12:00:00.000Z", "components": { "api": true, "database": true, "upstream": true } }

On this page