Usage history

curl --request GET \
  --url https://api.tryhuntr.com/usage \
  --header 'x-api-key: <api-key>'

{
  "requests": [
    {
      "id": "req_1746123456_ab3x9k",
      "prompt": "Find CEO of Stripe",
      "result": "Patrick Collison is the CEO of Stripe...",
      "tier": "standard",
      "model": "gemini-2.5-flash",
      "cost": 0.027,
      "capabilities_used": [
        "search_and_scrape",
        "news_search"
      ],
      "timestamp": "2026-05-03T12:00:45Z"
    }
  ],
  "total_requests": 42,
  "total_cost": 1.28
}

Account

Usage history

Requires x-api-key header.

Rate limit: 5 requests/second per API key.

Returns the last 500 requests for this key, newest first. Includes both /research calls and Direct API calls (/company-tech-stack, /company-linkedin, /company-contact, /company-jobs, /page-scrape, /page-analyze, /page-find, /company-search, /company-search-count, /person-search, /person-search-count, /person-email, /person-linkedin-url, /person-linkedin, /company-linkedin-url). Use limit and offset for pagination.

Research entries have model set to the synthesis model used (e.g. gemini-2.5-flash) and prompt is the research question.

Direct API entries have model: "none" and prompt is formatted as endpoint:input (e.g. company-contact:stripe.com, company-jobs:stripe.com, page-find:stripe.com, person-email:Patrick Collison:stripe.com, person-linkedin-url:Patrick Collison:stripe.com, company-linkedin-url:stripe.com, person-linkedin:https://linkedin.com/in/username). The result field contains the raw structured data from the endpoint.

GET

usage

Usage history

curl --request GET \
  --url https://api.tryhuntr.com/usage \
  --header 'x-api-key: <api-key>'

{
  "requests": [
    {
      "id": "req_1746123456_ab3x9k",
      "prompt": "Find CEO of Stripe",
      "result": "Patrick Collison is the CEO of Stripe...",
      "tier": "standard",
      "model": "gemini-2.5-flash",
      "cost": 0.027,
      "capabilities_used": [
        "search_and_scrape",
        "news_search"
      ],
      "timestamp": "2026-05-03T12:00:45Z"
    }
  ],
  "total_requests": 42,
  "total_cost": 1.28
}

Authorizations

x-api-key

string

header

required

Your Huntr API key. Get one at tryhuntr.com. Pass as x-api-key header on all authenticated requests.

Query Parameters

limit

integer

default:10

Number of entries to return.

Required range: x <= 500

offset

integer

default:0

Entries to skip (for pagination).

Response

Usage history, newest first.

requests

object[]

Paginated slice of the last 500 requests, newest first.

Show child attributes

total_requests

integer

Total number of requests stored for this key (up to 500 most recent).

total_cost

number

Sum of cost across all stored requests in USD.

Check balance & rate limit Add credits via Stripe

⌘I