Skip to main content
Credits control how many result‑returning queries your API key can make during a billing period, based on your Specter subscription. Credits are shared across endpoints that return results (e.g., companies, people, emails, etc.).

​
Billing period & renewals

  • When your API key is issued, you’re assigned a monthly credit allowance.
  • Your period renews on the same day each month (or on the last day of shorter months). Eg. If your renewal date is the 30th or 31st, your February reset occurs on the 28th.

​
Basic credit allowance

  • Allowance is per team (not per team member) and is shared across all endpoints that return results.
  • Credits reset on your team’s monthly renewal date and do not roll over between periods.

​
How credits are used

  • Credits are consumed when you call endpoints that return results.
  • Example: with a limit of 100 credits, if you first query to get search info and then request 48 results for that search, you’ll use 48 credits and have 52 remaining.
  • Most endpoints consume 1 credit per successful result returned.

​
Response headers (credit‑metering)

Any query that is subject to credit limiting includes these headers in the response:
  • X-CreditLimit-Limit – Total number of credits available this period
  • X-CreditLimit-Remaining – Credits left in the current period
  • X-CreditLimit-Reset – Seconds (decimal) until credits reset

​
Need more credits?

If all credits are used, further requests return HTTP 429 with an errorCode of OUT_OF_CREDITS, indicating you’ve been credit‑limited.  Wait until the reset time indicated by X-CreditLimit-Reset, or email support@tryspecter.com to increase your allowance.