Account · Guide

How to get Account request history

TL;DR
To get Account request history, sign up for a free Captapi key, then send one 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. See recent API requests made with your Captapi key — path, status, and credits used.

How to get Account request history (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 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. 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": [
      {
        "endpoint": "/v1/instagram/basic-profile",
        "platform": "instagram",
        "resource_url": "instagram_user:adencylnozturk",
        "credits_used": 0,
        "cache_hit": true,
        "status_code": 200,
        "response_time_ms": 154,
        "error_message": null,
        "created_at": "2026-07-18T11:31:44.31599+00:00"
      },
      {
        "endpoint": "/v1/instagram/basic-profile",
        "platform": "instagram",
        "resource_url": "instagram_user:adencylnozturk",
        "credits_used": 1,
        "cache_hit": false,
        "status_code": 200,
        "response_time_ms": 4980,
        "error_message": null,
        "created_at": "2026-07-18T11:31:21.584147+00:00"
      },
      {
        "endpoint": "/v1/instagram/basic-profile",
        "platform": "instagram",
        "resource_url": "instagram_user:adencylnozturk",
        "credits_used": 1,
        "cache_hit": false,
        "status_code": 200,
        "response_time_ms": 4168,
        "error_message": null,
        "created_at": "2026-07-18T11:31:20.30634+00:00"
      },
      {
        "endpoint": "/v1/pinterest/board",
        "platform": "pinterest",
        "resource_url": "https://www.pinterest.com/potterybarn/indigo-blues-lookbook/",
        "credits_used": 3,
        "cache_hit": false,
        "status_code": 200,
        "response_time_ms": 17558,
        "error_message": null,
        "created_at": "2026-07-18T11:29:07.873651+00:00"
      },
      {
        "endpoint": "/v1/facebook/marketplace-item",
        "platform": "facebook",
        "resource_url": "https://www.facebook.com/marketplace/item/2228870800986975/",
        "credits_used": 1,
        "cache_hit": false,
        "status_code": 200,
        "response_time_ms": 10482,
        "error_message": null,
        "created_at": "2026-07-18T11:28:59.677517+00:00"
      }
    ]
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
limitintegerNoMax items to return (default 50, max 500). Billed per result.

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 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 and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to get Account request history?

Start free with 100 credits — no credit card required.

Get your free API key