POST
/
v1
/
data
/
search
/
companies
curl --request POST \
  --url https://api.linkupapi.com/v1/data/search/companies \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "keyword": {},
  "industry": {},
  "location": {},
  "employee_range": {},
  "founding_company": true,
  "total_results": 123
}'
{
  "status": "success",
  "data": {
    "total_results": 2847,
    "companies": [
      {
        "url": "https://uk.linkedin.com/company/crm.com",
        "title": "CRM.COM - LinkedIn",
        "description": "CRM.COM is a global specialist in designing and developing commerce, fintech and subscription-based solutions, ideal for the new generation digital consumers."
      },
      {
        "url": "https://www.linkedin.com/company/recruitcrm",
        "title": "Recruit CRM - LinkedIn",
        "description": "Recruit CRM builds cloud-based software for the global Recruitment & Staffing industry. We are on a mission to help recruitment firms grow faster with cutting ..."
      },
      {
        "url": "https://www.linkedin.com/company/aesthetix-crm",
        "title": "Aesthetix CRM - LinkedIn",
        "description": "The #1 CRM platform for plastic surgeons and medical spas. Aesthetix CRM gives your practice access to all the tools you need to grow."
      }
    ]
  }
}

​
Description

This endpoint allows you to search LinkedIn company pages using various advanced filtering criteria.

​
Headers

​
x-api-key
string
required

Your API key for authentication

​
Body Parameters

​
keyword
string | array
required

Keyword(s) to search for (company name, industry, etc.)

  • Single string: Performs advanced search with filters
  • Array of strings: Automatically switches to batch mode for parallel searching
  • Also supports company_name for backward compatibility
​
industry
string | array

Industry sector(s) (e.g., “technology”, “finance”, “healthcare”)

Can be a single string or an array of industries

​
location
string | array

Location(s) (e.g., “Paris”, “France”, “New York”)

Can be a single string or an array of locations

​
employee_range
string | array

Employee count range(s) (e.g., “1-50”, “51-200”, “201-1000”, “1000+”)

Can be a single string or an array of employee ranges for multiple size categories

​
founding_company
boolean

Filter for founding companies

  • true: Search only founding companies
  • false: Exclude founding companies
​
total_results
integer
default:"10"

Number of results to return

  • Minimum: 1
  • Maximum: 50,000
  • Default: 10

​
Response

​
status
string

Response status (“success” or “error”)

​
data
object
​
message
string

Error message (if status = “error”)

​
Request Example

import requests

url = "https://api.linkupapi.com/v1/data/search/companies"

payload = {
    "keyword": "technology",
    "industry": "technology",
    "location": "Paris",
    "employee_range": "51-200",
    "founding_company": True,
    "total_results": 20
}
headers = {
    "x-api-key": "your-api-key-here",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "keyword": "technology",
  "industry": "technology",
  "location": "Paris",
  "employee_range": "51-200",
  "founding_company": true,
  "total_results": 20
}

​
Request Example with Arrays

import requests

url = "https://api.linkupapi.com/v1/data/search/companies"

payload = {
    "keyword": ["technology", "fintech", "startup"],
    "industry": ["technology", "finance", "healthcare"],
    "location": ["Paris", "Lyon", "Bordeaux"],
    "employee_range": ["1-50", "51-200", "201-1000"],
    "founding_company": True,
    "total_results": 30
}
headers = {
    "x-api-key": "your-api-key-here", 
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "keyword": ["technology", "fintech", "startup"],
  "industry": ["technology", "finance", "healthcare"],
  "location": ["Paris", "Lyon", "Bordeaux"],
  "employee_range": ["1-50", "51-200", "201-1000"],
  "founding_company": true,
  "total_results": 30
}

​
Response Example

{
  "status": "success",
  "data": {
    "total_results": 2847,
    "companies": [
      {
        "url": "https://uk.linkedin.com/company/crm.com",
        "title": "CRM.COM - LinkedIn",
        "description": "CRM.COM is a global specialist in designing and developing commerce, fintech and subscription-based solutions, ideal for the new generation digital consumers."
      },
      {
        "url": "https://www.linkedin.com/company/recruitcrm",
        "title": "Recruit CRM - LinkedIn",
        "description": "Recruit CRM builds cloud-based software for the global Recruitment & Staffing industry. We are on a mission to help recruitment firms grow faster with cutting ..."
      },
      {
        "url": "https://www.linkedin.com/company/aesthetix-crm",
        "title": "Aesthetix CRM - LinkedIn",
        "description": "The #1 CRM platform for plastic surgeons and medical spas. Aesthetix CRM gives your practice access to all the tools you need to grow."
      }
    ]
  }
}

​
Error Codes

{
  "status": "error",
  "message": "keyword (or company_name) is required"
}
  • 400: Invalid or missing parameters
  • 401: Invalid API key or insufficient credits
  • 500: Server error during request processing

​
Important Notes

  • Each successful search consumes 1 credit (single keyword) or 1 credit per keyword (multiple keywords)
  • Credits are only deducted on successful searches
  • The endpoint uses an automatic retry system for proxy errors
  • The company_name parameter is supported for backward compatibility with keyword
  • Single keyword: Advanced search with optional filters for precise results
  • Multiple keywords: Automatically activates batch mode for parallel searching
  • Most search parameters support both single strings and arrays for flexible searching
  • When using multiple keywords, batch mode is automatically activated for optimal performance

​
Usage Examples

​
Basic search with keyword only

{
  "keyword": "artificial intelligence",
  "total_results": 10
}

​
Search with industry and location filters

{
  "keyword": "software",
  "industry": "technology",
  "location": "San Francisco",
  "total_results": 25
}

​
Search with employee range and founding filter

{
  "keyword": "fintech",
  "employee_range": "1-50",
  "founding_company": true,
  "total_results": 15
}

​
Batch search with multiple keywords

{
  "keyword": ["fintech", "blockchain", "cryptocurrency"],
  "industry": ["Finance", "Technology"],
  "location": ["New York", "San Francisco", "London"],
  "employee_range": ["51-200", "201-1000"],
  "total_results": 100
}

​
Advanced search with multiple industries and locations

{
  "keyword": "startup",
  "industry": ["Technology", "Healthcare", "Finance"],
  "location": ["Paris", "Lyon", "Marseille"],
  "employee_range": ["1-50", "51-200"],
  "founding_company": true,
  "total_results": 50
}

​
Search with specific number of results

{
  "keyword": "artificial intelligence",
  "industry": "Technology",
  "total_results": 10
}