Run a saved search

Runs a saved people search and returns one page of people, as POST /v1/people/search does with savedSearchId. The stored filters are the search: the body only pages it (limit, cursor) or narrows it to one person (linkedinUrl). Stored filters the search no longer takes are left out and listed in ignoredFilterKeys.

A saved company search answers 422 saved_search_type_mismatch: run it with POST /v1/companies/search and savedSearchId.

Price: $0.0001 per person returned. Before the search runs, limit times $0.0001 is held from your balance, and what the page does not use is released. A page with nothing on it costs nothing. Scope: search. Read-only keys may call it.

POST /v1/saved-searches/{savedSearchId}/run

Run a saved search

cURL

curl --request POST \
  --url https://api.outbound.dev/v1/saved-searches/{savedSearchId}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "limit": 10
}'

200

{
  "data": [
    {
      "linkedinMemberId": "ACoAAB2cdEF",
      "linkedin_url": "linkedin.com/in/ana-ruiz-ops",
      "full_name": "Ana Ruiz",
      "first_name": "Ana",
      "last_name": "Ruiz",
      "job_title": "Director of Operations",
      "job_title_levels": [
        "director"
      ],
      "job_title_role": "operations",
      "job_company_name": "Halden Freight",
      "job_company_website": "haldenfreight.com",
      "job_company_linkedin_url": "linkedin.com/company/halden-freight",
      "job_company_employee_count": 240,
      "location_name": "lisbon, lisbon, portugal"
    }
  ],
  "pagination": {
    "nextCursor": "c2Nyb2xsXzI",
    "total": 1246
  },
  "filters": {
    "job_title_levels": [
      "director"
    ],
    "job_title_role": [
      "operations"
    ],
    "job_company_location_country": [
      "portugal"
    ]
  }
}

Authorizations

Authorization · string · header · required

An API key from the console, starting ob_live_, sent as Authorization: Bearer <key>.

Path Parameters

savedSearchId · string · required

The saved search's id.

Required string length: 24

Pattern: ^[0-9a-fA-F]+$

Body

application/json

limit · integer · default: 10

People per page. The page's most possible cost, limit times $0.0001, is held from your balance first.

Required range: 1 <= x <= 100

cursor · string

The pagination.nextCursor of the page before. Send it with the same search, as the filters the first page answered with.

Required string length: 1 - 4096

linkedinUrl · string

Narrow the saved search to one person, by LinkedIn profile URL.

Required string length: 1 - 2048

Response

200

application/json

One page of people.

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes

filters · object · required

The filters the search ran with. Send them with cursor for the next page, or save them as a saved search.

unresolvedCriteria · string[]

With query: the parts of it that could not be turned into a filter.

closestCompanyMatches · object[]

With query: each company it named that the search chose between same-named companies for, and the one chosen.

Show child attributes

ignoredFilterKeys · string[]

With a saved search: stored filters the search no longer takes, left out.

unappliedCompanyNames · object[]

Company names in the filters the search could not apply yet, by filter.