Developers
Open Swarmhit
Smart APIRaw API
API referenceLinkedin search
POST
/api/v1/linkedin/account_search

A Sales Navigator company search URL, or free-text keywords. It runs a company search only: any other link (a people or classic search, a Sales Navigator page with no search in it, a blank query, a port or user name, over 4,000 characters) is a 400 bad-request and nothing runs. Items have type: COMPANY; paged like the people search. Needs a Sales Navigator seat (422 feature_not_subscribed).

Authorization

X-API-KEY<token>

Your API key from the console (gw_live_…).

In: header

Query Parameters

account_id*string

The LinkedIn account (lg_…) to act as.

Length1 <= length
cursor?string

The cursor the previous page answered, passed back unchanged, for the next page. Leave it out for the first page; a null cursor means there is no next page. Opaque: its form differs by route.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/linkedin/account_search?account_id=lg_3f9c2a7b1d" \  -H "Content-Type: application/json" \  -d '{    "keywords": "example corp"  }'
{  "object": "LinkedinSearch",  "items": [    {      "object": "SearchResult",      "type": "COMPANY",      "id": "1234567",      "company_urn": "urn:li:fs_salesCompany:1234567",      "name": "Example Corp",      "industry": "Software Development",      "location": "Paris",      "employee_count": 120,      "saved": false,      "profile_url": "https://www.linkedin.com/sales/company/1234567",      "profile_picture_url": null    }  ],  "paging": {    "total_count": 1,    "page_count": 1,    "start": 0  },  "cursor": null}

Search people POST

A pasted search URL (classic people search, or Sales Navigator people or companies), or search params. A classic search reads one page of LinkedIn's results, with no totals; a Sales Navigator search runs on the account's seat, 25 a page, with totals. One page a call; pass `cursor` for the next. A filter Swarmhit cannot map is 422: paste the URL instead.

Handle a received invitation POST

`action` `accept` (the default) accepts it; `decline` ignores it, as the invitation manager's Ignore does (the inviter is not told). Both are writes under the `accept` daily cap. With `shared_secret` (from `GET /users/invite/received`) it is used as given; without it, the invitation must be among the newest 100 received, 404 otherwise.