---
title: "Retrieve LinkedIn search parameters"
method: GET
path: "/api/v1/linkedin/search/parameters"
tags: ["LinkedIn Specific"]
---

# Retrieve LinkedIn search parameters

`GET /api/v1/linkedin/search/parameters`

LinkedIn doesn't accept raw text as search parameters, but IDs. This route will help you get the right IDs for your inputs. Check out our Guide with examples to master LinkedIn search : https://developer.unipile.com/docs/linkedin-search

## Query parameters

- `limit` integer — A limit for the number of items returned in the response. The value can be set between 1 and 100.
- `keywords` string
- `service` 'CLASSIC' | 'RECRUITER' | 'SALES_NAVIGATOR'
- `type` union, required
  - 'LOCATION' | 'PEOPLE' | 'CONNECTIONS' | 'COMPANY' | 'SCHOOL' | 'INDUSTRY' | 'SERVICE' | 'JOB_FUNCTION' | 'JOB_TITLE' | 'EMPLOYMENT_TYPE' | 'SKILL'
  - 'GROUPS' | 'SALES_INDUSTRY' | 'DEPARTMENT' | 'PERSONA' | 'ACCOUNT_LISTS' | 'LEAD_LISTS' | 'TECHNOLOGIES' | 'SAVED_ACCOUNTS' | 'SAVED_SEARCHES' | 'RECENT_SEARCHES' | 'REGION' | 'POSTAL_CODE'
  - 'GROUPS' | 'DEPARTMENT' | 'HIRING_PROJECTS' | 'SAVED_SEARCHES' | 'SAVED_FILTERS' | 'DEGREE'
- `account_id` string, required

## Response `200`

OK. Request succeeded.

- object
  - `object` 'LinkedinSearchParametersList', required
  - `items` object[], required
    - `object` 'LinkedinSearchParameter', required
    - `id` string, required — A unique identifier.
    - `title` string, required
    - `picture_url` string
    - `additional_data` object
  - `paging` object, required
    - `page_count` number, required

## Other responses

- `400` — ## Bad Request ### Invalid parameters One or more request parameters are invalid or missing. undefined
- `401` — ## Unauthorized ### Disconnected account The account appears to be disconnected from the provider service. undefined
- `403` — ## Forbidden ### Insufficient permissions - Type: "errors/insufficient_permissions" Valid authentication but insufficient permissions to perform the request. ### Account restricted - Type: "errors/account_restricted" Access to this account has been restricted by the provider. ### Account mismatch - Type: "errors/account_mismatch" This action cannot be done with your account. ### Unknown authentication context - Type: "errors/unknown_authentication_context" An additional step seems necessary to complete login. Please connect to provider with your browser to find out more, then retry authentication. ### Session mismatch - Type: "errors/session_mismatch" Token User id does not match client session id. ### Feature not subscribed - Type: "errors/feature_not_subscribed" The requested feature has either not been subscribed or not been authenticated properly. ### Subscription required - Type: "errors/subscription_required" The action you're trying to achieve requires a subscription to provider's services. ### Resource access restricted - Type: "errors/resource_access_restricted" You don't have access to this resource. ### Action required - Type: "errors/action_required" An additional step seems necessary. Complete authentication on the provider's native application and try again.
- `404` — ## Not Found ### Resource not found. The requested resource were not found. Account not found
- `429` — ## Too Many Requests ### Too many requests The provider cannot accept any more requests at the moment. Please try again later. undefined
- `500` — ## Internal Server Error ### Unexpected error - Type: "errors/unexpected_error" Something went wrong. {{moreDetails}} ### Provider error - Type: "errors/provider_error" The provider is experiencing operational problems. Please try again later. ### Authentication intent error - Type: "errors/authentication_intent_error" The current authentication intent was killed after failure. Please start the process again from the beginning.
- `503` — ## Service Unavailable ### No client session - Type: "errors/no_client_session" No client session is currently running. ### No channel - Type: "errors/no_channel" No channel to client session. ### Handler missing - Type: "errors/no_handler" Handler missing for that request. ### Network down - Type: "errors/network_down" Network is down on server side. Please wait a moment and retry. ### Service unavailable - Type: "errors/service_unavailable" Please try again later.
- `504` — ## Gateway Timeout ### Request timed out - Type: "errors/request_timeout" Request Timeout. Please try again, and if the issue persists, contact support.

---

[API](https://skmtc.net/unipile/apis/unipile-api-reference.md) · [All operations](https://skmtc.net/unipile/apis/unipile-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unipile/unipile-api-reference/versions/3483a34061f6/schema)