Skip to main content
GET
/
searches
/
companies
/
{searchId}
Get company saved search details
curl --request GET \
  --url https://app.tryspecter.com/api/v1/searches/companies/{searchId} \
  --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,
  "new_funding_highlights_count": 1,
  "new_growth_highlights_count": 1
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
searchId
string
required

The search ID that is being queried for.

Response

The details of the query for a given search id.

​
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

​
new_funding_highlights_count
number

The number of companies that have new funding highlights in this search.

Example:

1

​
new_growth_highlights_count
number

The number of companies that have new growth highlights in this search.

Example:

1