---
title: "Look up the id for a search filter"
method: POST
path: "/v1/actions/lookup_search_ids"
tags: ["Search"]
---

# Look up the id for a search filter

`POST /v1/actions/lookup_search_ids`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/lookup_search_ids`
- Auth: HTTP bearer

Find LinkedIn's id for a place, company, school, industry, job title and the like, by name.

An id is good only for filters that ask for the same type: a LOCATION id is not a REGION id.

service selects which product's list is searched. Some types exist only for Sales Navigator (SALES_INDUSTRY, POSTAL_CODE, PERSONA, ACCOUNT_LISTS, LEAD_LISTS, TECHNOLOGIES, SAVED_ACCOUNTS, RECENT_SEARCHES), only for Recruiter (HIRING_PROJECTS, SAVED_FILTERS, DEGREE), or for those two and not ordinary LinkedIn (GROUPS, DEPARTMENT, SAVED_SEARCHES).

It has no cursor: narrow the keywords instead.

Docs: https://heyreagent.com/docs/actions/lookup_search_ids

## Request body

- object
  - `type` 'LOCATION' | 'REGION' | 'PEOPLE' | 'CONNECTIONS' | 'COMPANY' | 'SCHOOL' | 'INDUSTRY' | 'SERVICE' | 'JOB_FUNCTION' | 'JOB_TITLE' | 'EMPLOYMENT_TYPE' | 'SKILL' | 'LANGUAGE' | 'POST_JOB_FUNCTION' | 'SENIORITY' | 'GROUPS' | 'SALES_INDUSTRY' | 'DEPARTMENT' | 'PERSONA' | 'ACCOUNT_LISTS' | 'LEAD_LISTS' | 'TECHNOLOGIES' | 'SAVED_ACCOUNTS' | 'SAVED_SEARCHES' | 'RECENT_SEARCHES' | 'POSTAL_CODE' | 'HIRING_PROJECTS' | 'SAVED_FILTERS' | 'DEGREE', required: What kind of thing to look up.
  - `keywords` string: The name to look for, e.g. "Berlin" or "Software". Not used for EMPLOYMENT_TYPE.
  - `service` 'CLASSIC' | 'SALES_NAVIGATOR' | 'RECRUITER': Whose list to search (default CLASSIC).
  - `limit` number: How many to return (1–100, default 10).
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: returned, nextCursor, matches[].id, matches[].title, matches[].pictureUrl.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)