---
title: "Search LinkedIn profiles"
method: POST
path: "/v1/linkedin/searchProfiles"
tags: ["linkedin"]
---

# Search LinkedIn profiles

`POST /v1/linkedin/searchProfiles`

## Request

- Base URL: `https://api.zevari.ai`
- URL: `https://api.zevari.ai/v1/linkedin/searchProfiles`
- Auth: HTTP bearer

Transport: call this endpoint with HTTP POST and a JSON request body. Search LinkedIn for PEOPLE by keywords, job title, industry, location, seniority, or company size (names are auto-resolved to LinkedIn parameter IDs). Returns profiles with provider IDs for follow-up actions. Does NOT search posts (use linkedin_search_posts) or companies (use linkedin_search_companies). Seniority and company-size filters apply only when the connected LinkedIn account includes Sales Navigator (Zevari routes those searches through Sales Navigator automatically); otherwise they are ignored with a note. Standard (non–Sales Navigator) people search returns at most 10 profiles per page and no total result count — use next_cursor to page.

## Request body

- object
  - `query` string, required: Search query — can be keywords, job title, company, etc.
  - `keywords` string[]: Keyword filters
  - `job_titles` string[]: Job title filters, matched against profile titles as keywords (OR-combined)
  - `industries` string[]: Industry filters — plain names (auto-resolved to LinkedIn parameter IDs) or numeric IDs from linkedin_lookup_search_params
  - `locations` string[]: Location filters — plain names like "United States" (auto-resolved to LinkedIn parameter IDs) or numeric IDs from linkedin_lookup_search_params
  - `seniority_levels` string[]: Seniority filters, e.g. "C-Level", "VP", "Director", "Manager", "Owner". Applied via Sales Navigator when the connected LinkedIn account includes it; otherwise ignored with a note (express seniority in job_titles/keywords instead).
  - `company_sizes` string[]: Company headcount buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Applied via Sales Navigator when the connected LinkedIn account includes it; otherwise ignored with a note.
  - `search_url` string: A copied LinkedIn people-search URL to run directly instead of filters. Standard URLs (linkedin.com/search/results/people/...) work for every account; Sales Navigator URLs (linkedin.com/sales/...) require the connected account to include Sales Navigator.
  - `limit` integer: Page size. Sales Navigator routes allow up to 100; standard LinkedIn search is capped at 10 per page.
  - `cursor` string: Opaque pagination cursor from the previous response's next_cursor

## Response `200`

Successful Zevari API response.

- ZevariResponseEnvelope
  - `ok` boolean, required: False when the underlying tool reports an error or a partial failure.
  - `method` string, required: Public API method name.
  - `data` unknown, required
  - `request_id` string, required: Request correlation ID. Also returned in X-Zevari-Request-Id.

## Other responses

- `400`: Invalid arguments or method execution error.
- `401`: Missing, invalid, expired, revoked, or unauthorized API key.
- `404`: Unknown or non-public Zevari API method.
- `429`: API key rate limit exceeded.
- `500`: Unhandled server error.

---

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