Authentication

Specter uses a single, team-level API key, so every call is tied to your firm’s workspace. Rate and credit limits apply at the workspace level.

Your API key

Your key lives in the API Console; copy it straight to your clipboard. No key yet? Click Request API Access there; requests are reviewed and approved within one business day.

Why only one key per team?

Most investment teams work collaboratively from one source of truth. A shared key keeps data permissioning straightforward while still enforcing rate and credit limits at the workspace level.

Making an authenticated request

curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/companies \
  --header 'X-API-Key: YOUR_API_KEY'

import requests

resp = requests.get(
    "https://app.tryspecter.com/api/v1/lists/companies",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(resp.json())

const res = await fetch("https://app.tryspecter.com/api/v1/lists/companies", {
  headers: { "X-API-Key": "YOUR_API_KEY" },
});
const data = await res.json();

For a full walkthrough of your first request, see the Quickstart.

Keep your key safe

Treat the key like a password; it grants access to your firm’s data.

Store it in an environment variable (e.g. SPECTER_API_KEY), never hard-coded in source.
Never put it in client-side code, a browser, or a public repository.
If a key is exposed, contact api-support@tryspecter.com to rotate it.

Authentication errors

Code	Meaning	Fix
`401`	Missing or invalid key	Confirm you’re sending the `X-API-Key` header (not `Authorization: Bearer`) and the key is correct and active.
`403`	Key is valid, but your plan doesn’t include this endpoint	Contact support to discuss access.

For the full list, including credit (402) and rate (429) limits, see Errors.

What the API can see

Lists and saved searches are only visible to the API once shared with it (a one-click toggle in the app); full rules in Lists and Saved Searches.

Get started

Core Data

Signals

Network Mapping

Workflows

Resources

Your API key

Making an authenticated request

Keep your key safe

Authentication errors

What the API can see

​Your API key

​Making an authenticated request

​Keep your key safe

​Authentication errors

​What the API can see

Your API key

Making an authenticated request

Keep your key safe

Authentication errors

What the API can see