LinkedIn API · Endpoint

LinkedIn Company Suggestions API

Q: What do I send?

Send query. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds linkedin.company.search, checks its price and runs it with the same credits as the REST API.

Turn a company name into LinkedIn company IDs, so you can pass the right one to the jobs and posts endpoints.

1 credit per call
Failed calls are free
Updated 14 Oct 2026
linkedin.company.search

Start free, 100 credits API reference

Response completed

{  "count": 1,  "matched_count": 1,  "total_suggestions": 10,  "results": [    {      "name": "Microsoft",      "company_id": "1035",      "url": "https://www.linkedin.com/company/1035"    }  ]}

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
query	string	yes	Company-name autocomplete query; only COMPANY suggestions are returned.	Microsoft
limit	integer	no	Maximum company suggestions returned. The source has no observed pagination. From 1 to 10. Default: `10`.	10
match_mode	string	no	Local name filter on suggestions, case-insensitive. all preserves source suggestions; exact requires equal names; prefix requires a name beginning with query. Allowed values: `all`, `exact`, `prefix`. Default: `all`.	exact

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
results[].name	string	The company's name.	Microsoft
results[].company_id	string	LinkedIn's numeric ID for the company; the jobs and posts endpoints take it.	1035
results[].url	string	The company on LinkedIn.	https://www.linkedin.com/company/1035
count	integer	Companies in this response.	1
matched_count	integer	Suggestions that matched your name.	1
results	array	Companies matching the name.	1 records
total_suggestions	integer	Suggestions LinkedIn gave.	10

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "linkedin.company.search",  "input": {    "limit": 10,    "match_mode": "exact",    "query": "Microsoft"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "linkedin.company.search",  "input": {    "limit": 10,    "match_mode": "exact",    "query": "Microsoft"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "linkedin.company.search",  "input": {    "limit": 10,    "match_mode": "exact",    "query": "Microsoft"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

With Upscrape, get the LinkedIn company suggestions for match mode "exact" and query "Microsoft". Tell me what it costs before you run it, then show the results as a table.

The agent finds the endpoint, shows you the price, and runs it with your credits.