POST
/
v1
/
companies
/
search
curl --request POST \
  --url https://api.linkupapi.com/v1/companies/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "location": "<string>",
  "sector": "<string>",
  "keyword": "<string>",
  "company_size": "<string>",
  "total_results": 123,
  "start_page": 123,
  "end_page": 123,
  "country": "<string>",
  "login_token": "<string>"
}'
{
  "status": "success",
  "data": {
    "total_results": 2,
    "total_available_results": 1368,
    "companies": [
      {
        "company_name": "Software République",
        "company_url": "https://www.linkedin.com/company/softwarerepublique/",
        "job_offers": null,
        "subscribers": "4 k abonnés",
        "location": "Développement de logiciels • Paris",
        "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQEOM_2p0wtaWQ/company-logo_100_100/company-logo_100_100/0/1653290912803?e=1749081600&v=beta&t=qshekRz09DUyP6lo2KEQppZBMj-gJ7zmzj-3saswwkA"
      },
      {
        "company_name": "Software Club",
        "company_url": "https://www.linkedin.com/company/softwareclub/",
        "job_offers": "2 offres d'emploi",
        "subscribers": "8 k abonnés",
        "location": "Technologie, information et Internet • Paris, Île-de-France",
        "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQGtU0gjNC8ONw/company-logo_100_100/company-logo_100_100/0/1673453153703/softwareclub_logo?e=1749081600&v=beta&t=E4mMCkbmbIcBbLsAHSj_PGP5FBHPQfJ3eVlexTGEdo8"
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 1,
      "results_per_page": 50,
      "pages_fetched": 1
    }
  }
}

Search and retrieve information about companies on LinkedIn using filters like location, sector, keywords, and company size.

Credit Usage: 1 credit per 10 results (or fraction thereof). For example:

  • 1-10 results = 1 credit
  • 11-20 results = 2 credits
  • 300 results = 30 credits

​
Header Parameters

​
x-api-key
string
required

Your API key

​
Body Parameters

​
location
string

Geographic location for company search (e.g., “Paris”, “France”, “Europe”). Use semicolon (;) as separator for multiple locations (e.g., “Paris;London;Berlin”).

​
sector
string

Industry sector you can find the label here: https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2 Use semicolon (;) as separator for multiple sectors (e.g., “Software;Finance;Marketing”).

​
keyword
string

Search keyword or company name

​
company_size
string

Employee count range: 1-10 employees 11-50 employees 51-200 employees 201-500 employees 501-1000 employees 1001-5000 employees 5001-10000 employees 10001+ employees

​
total_results
integer
default:"10"

Number of companies to return (used when not in pagination mode)

​
start_page
integer

First page to fetch when using pagination mode (default: 1)

​
end_page
integer

Last page to fetch when using pagination mode (default: same as start_page)

​
country
string
default:"FR"

Country code for proxy selection. Available: (US,UK,FR)

​
login_token
string
required

LinkedIn authentication cookie obtained from the login/verify process

​
Response

​
status
string

Request status (success/error)

​
data
object
{
  "status": "success",
  "data": {
    "total_results": 2,
    "total_available_results": 1368,
    "companies": [
      {
        "company_name": "Software République",
        "company_url": "https://www.linkedin.com/company/softwarerepublique/",
        "job_offers": null,
        "subscribers": "4 k abonnés",
        "location": "Développement de logiciels • Paris",
        "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQEOM_2p0wtaWQ/company-logo_100_100/company-logo_100_100/0/1653290912803?e=1749081600&v=beta&t=qshekRz09DUyP6lo2KEQppZBMj-gJ7zmzj-3saswwkA"
      },
      {
        "company_name": "Software Club",
        "company_url": "https://www.linkedin.com/company/softwareclub/",
        "job_offers": "2 offres d'emploi",
        "subscribers": "8 k abonnés",
        "location": "Technologie, information et Internet • Paris, Île-de-France",
        "logo_url": "https://media.licdn.com/dms/image/v2/C4E0BAQGtU0gjNC8ONw/company-logo_100_100/company-logo_100_100/0/1673453153703/softwareclub_logo?e=1749081600&v=beta&t=E4mMCkbmbIcBbLsAHSj_PGP5FBHPQfJ3eVlexTGEdo8"
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 1,
      "results_per_page": 50,
      "pages_fetched": 1
    }
  }
}

​
Notes

  • All filter parameters are optional but at least one should be provided for meaningful results
  • Results are paginated with a maximum of 50 companies per page
  • Location and sector IDs are automatically resolved from provided strings
  • The total_available_results field shows the total number of companies that match your search criteria on LinkedIn
  • The job_offers field may be null if no job listings are currently available
  • Pagination Mode vs. Total Results Mode:
    • Total Results Mode: Use the total_results parameter to specify how many companies you want (default)
    • Pagination Mode: Use start_page and end_page parameters to fetch specific pages of results
    • Credit usage in pagination mode is based on the number of pages fetched (1 credit per page)
    • When using pagination mode, total_results parameter is ignored