Skip to main content
Specter’s API uses a single, team‑level API key so every call is tied to your firm’s workspace. 

​
Accessing Your Key

You can locate your API key in the API Console, where you can copy it directly to your clipboard. If you don’t see a key within your API Console:
Hit Request API Access and we’ll review and approve your request the same day, so you can start using your key right away.
There is one API Key for the whole team.
Why only one key?
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.

​
Keep your key secure

Do not share your key publicly
It should be treated with the same level of confidentiality as a password, as possession of the key grants access to your firm’s data within the platform.

​
Make an authenticated query

Once the API key is obtained it can be used in a query by passing it as a header to the query: 
  curl -X 'GET' \
    -H 'X-API-KEY: 1234-2345-3456-4567' \
    -H 'accept: application/json' \
    'https://app.tryspecter.com/api/v1/lists'

​
Data visibility

​
Sharing to API

  1. Within the platform, go to My Specter → Searches / Lists.
  2. Navigate to the saved search you wish to use via the API.
  3. Click the options menu […] and toggle Share with API.
  4. The saved search can now be queried and managed by the API. Toggle off at any time to remove API access.
Lists and saved searches are limited to those visible by the API:
  • Lists created via the API are automatically shared with the API and are immediately queryable.
  • Saved searches must have a unique name per user (you cannot create two with the same name).
  • Saved searches cannot be created via the API at this time.
⌘I