---
title: "LinkedIn proxy: scrape a search page"
method: GET
path: "/api/linkedin/{account_id}/scrape-search"
tags: ["LinkedIn – Profiles"]
---

# LinkedIn proxy: scrape a search page

`GET /api/linkedin/{account_id}/scrape-search`

## Request

- Base URL: `https://api.reachmcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reachmcp.com/api/linkedin/{account_id}/scrape-search`
- Auth: API key in header `X-API-Key`

Execute one page of a LinkedIn, Sales Navigator, or Recruiter search and return normalized profile rows.  The search type is detected automatically from ``url``:

- ``linkedin.com/talent`` → Recruiter (``talentRecruiterSearchHits``)
- ``linkedin.com/sales`` → Sales Navigator (``salesApiLeadSearch`` / ``salesApiPeopleSearch``)
- otherwise → Standard LinkedIn (Voyager ``searchDashClusters`` GraphQL)

Use ``start`` + ``count`` to paginate.

**Page size notes:**
- Sales Navigator / Recruiter: ``count`` is respected (max 25).
- Standard LinkedIn: ``count`` is **ignored** — the Voyager GraphQL endpoint uses a fixed page size of ~10 results per call imposed by LinkedIn.  Iterate with ``start`` += 10.

## Path parameters

- `account_id` integer, required

## Query parameters

- `url` string, required: LinkedIn / SalesNav / Recruiter search URL.
- `start` integer: Paging offset.
- `count` string, nullable: Page size (max 25, default 25). Ignored for standard LinkedIn — LinkedIn fixes the page size at ~10 results per call.

## Response `200`

Successful Response

- LinkedInScrapeSearchPageOut: Paged results from a LinkedIn, Sales Navigator, or Recruiter search URL.
  - `start` integer, required: Offset used for this request.
  - `count` integer, required: Requested page size.
  - `total` integer, nullable: Total results reported by LinkedIn.
  - `items` LinkedInScrapedUserOut[], required
    - `linkedin_id` string, required: Profile ID (fsd_profile or ts_profile suffix).
    - `linkedin_public_id` string, nullable: Vanity URL slug (/in/<slug>).
    - `linkedin_plain_id` string, nullable: Numeric member ID (objectUrn suffix).
    - `salesnavigator_url` string, nullable: Sales Navigator profile URL (SalesNav searches only).
    - `profile_url` string, nullable: Public LinkedIn profile URL.
    - `full_name` string, nullable: Full name as returned by LinkedIn (standard search only).
    - `firstname` string, nullable
    - `lastname` string, nullable
    - `headline` string, nullable
    - `location` string, nullable
    - `industry` string, nullable
    - `summary` string, nullable
    - `picture` string, nullable: Profile picture URL.
    - `job` string, nullable: Current job title.
    - `company` string, nullable: Current company name.
    - `company_id` string, nullable: LinkedIn company ID.
    - `company_industry` string, nullable
    - `company_location` string, nullable
    - `company_website` string, nullable
    - `company_employee_count` integer, nullable
    - `company_employee_range` string, nullable
    - `company_logo` string, nullable
    - `company_linkedin` string, nullable: LinkedIn company page URL.
    - `job_description` string, nullable
    - `startyear_position` integer, nullable
    - `startmonth_position` integer, nullable
    - `year_position` integer, nullable: Tenure at current position (years).
    - `month_position` integer, nullable: Tenure at current position (months).
    - `year_company` integer, nullable: Tenure at current company (years).
    - `month_company` integer, nullable: Tenure at current company (months).
    - `company_specialties` unknown
    - `company_description` string, nullable
    - `company_type` string, nullable
    - `company_year_founded` string, nullable
    - `is_premium` boolean, nullable
    - `is_open_profile` boolean, nullable
    - `is_opentowork` boolean, nullable
    - `connections` integer, nullable
    - `degree` integer, nullable: Network degree: 1, 2, or 3.
    - `skills` string[], nullable
    - `languages` string[], nullable
  - `next_start` integer, nullable: Pass as ``start`` for the next page when present.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reachmcp/apis/mcp-reach.md) · [All operations](https://skmtc.dev/reachmcp/apis/mcp-reach/llms.txt) · [OpenAPI document](https://skmtc.dev/reachmcp/apis/mcp-reach/revisions/1a85fdaf3f7c?raw)