How to get CaptAPI Account request history
GET request to /v1/account/request-history with your input. You get clean JSON back in seconds for 0 credits per call — no OAuth, scraping or platform SDKs. Recent API requests for your key — requestId, status, credits, cacheHit (0 credits).How to get CaptAPI Account request history (step by step)
- 1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
- 2
Call the Request History API
Send an authenticated GET request to /v1/account/request-history with your input. No OAuth, no scraping setup.
- 3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.
Code example
curl "https://api.captapi.com/v1/account/request-history?limit=20" \
-H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."What the response looks like
{
"success": true,
"data": {
"totalReturned": 5,
"requests": [
{
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"endpoint": "/v1/instagram/basic-profile",
"platform": "instagram",
"resource": "instagram_user:adencylnozturk",
"resourceUrl": "instagram_user:adencylnozturk",
"creditsUsed": 0,
"cacheHit": true,
"statusCode": 200,
"responseTimeMs": 154,
"errorMessage": null,
"createdAt": "2026-07-18T11:31:44.31599+00:00"
},
{
"requestId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"endpoint": "/v1/instagram/basic-profile",
"platform": "instagram",
"resource": "instagram_user:adencylnozturk",
"resourceUrl": "instagram_user:adencylnozturk",
"creditsUsed": 1,
"cacheHit": false,
"statusCode": 200,
"responseTimeMs": 4980,
"errorMessage": null,
"createdAt": "2026-07-18T11:31:21.584147+00:00"
},
{
"requestId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"endpoint": "/v1/instagram/basic-profile",
"platform": "instagram",
"resource": "instagram_user:adencylnozturk",
"resourceUrl": "instagram_user:adencylnozturk",
"creditsUsed": 1,
"cacheHit": false,
"statusCode": 200,
"responseTimeMs": 4168,
"errorMessage": null,
"createdAt": "2026-07-18T11:31:20.30634+00:00"
},
{
"requestId": "d4e5f6a7-b8c9-0123-def0-234567890123",
"endpoint": "/v1/pinterest/board",
"platform": "pinterest",
"resource": "https://www.pinterest.com/potterybarn/indigo-blues-lookbook/",
"resourceUrl": "https://www.pinterest.com/potterybarn/indigo-blues-lookbook/",
"creditsUsed": 3,
"cacheHit": false,
"statusCode": 200,
"responseTimeMs": 17558,
"errorMessage": null,
"createdAt": "2026-07-18T11:29:07.873651+00:00"
},
{
"requestId": "e5f6a7b8-c9d0-1234-ef01-345678901234",
"endpoint": "/v1/facebook/marketplace-item",
"platform": "facebook",
"resource": "https://www.facebook.com/marketplace/item/2228870800986975/",
"resourceUrl": "https://www.facebook.com/marketplace/item/2228870800986975/",
"creditsUsed": 1,
"cacheHit": false,
"statusCode": 200,
"responseTimeMs": 10482,
"errorMessage": null,
"createdAt": "2026-07-18T11:28:59.677517+00:00"
}
],
"filters": {
"endpoint": null,
"statusCode": null,
"since": null,
"until": null,
"limit": 5
}
}
}Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Max rows to return (default 50, max 500). Free — does not consume credits. |
| endpoint | string | No | Exact Captapi path filter, e.g. /v1/instagram/basic-profile. |
| statusCode | integer | No | Filter by HTTP status code (e.g. 500). |
| since | string | No | Inclusive lower bound on createdAt (ISO date or datetime). |
| until | string | No | Exclusive upper bound on createdAt (ISO date or datetime). |
Frequently asked questions
What does the Request History API do?
The Request History API returns request history for your Captapi API key via one GET request to /v1/account/request-history. It returns clean JSON and does not charge credits.
How many credits does the Request History API cost?
Account endpoints are free — they do not consume credits.
Do I need a CaptAPI Account API key or OAuth?
You only need your Captapi API key (Authorization: Bearer). No third-party OAuth is required.
Is the Request History API suitable for production use?
Yes. It is a stable REST endpoint with predictable JSON. Account endpoints are always live (never cached) and do not charge credits.
Ready to get CaptAPI Account request history?
Start free with 100 credits — no credit card required.
Get your free API key