Skip to main content
GET
/
searches
Get all saved searches
curl --request GET \
  --url https://app.tryspecter.com/api/v1/searches \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": 163,
    "name": "New Canada Companies",
    "is_global": false,
    "query_id": 10,
    "product_type": "company",
    "full_count": 100,
    "new_count": 1
  }
]

Authorizations

​
X-API-Key
string
header
required

Response

API searches

​
id
number

The search id for the search, this should be used to query for results for the search.

Example:

163

​
name
string

Name of the search

Example:

"New Canada Companies"

​
is_global
boolean

This flags searches recommended by Specter for all users

Example:

false

​
query_id
number

The query id that this search is related to, this can be used to query for the search in the address bar. https://app.staging.tryspecter.com/signals/company/feed?queryId=10

Example:

10

​
product_type
enum<string>

The type of product the search relates to.

Available options:
company,
investors,
people,
talent
​
full_count
number

The total number of companies that are returned by this search.

Example:

100

​
new_count
number

The number of new companies that have appeared in this search in the most recent month.

Example:

1

⌘I