Skip to main content
POST
/
v2
/
profiles
Search Companies
curl --request POST \
  --url https://api.example.com/v2/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "keyword": "<string>",
    "location": [
      "<string>"
    ],
    "sector": [
      "<string>"
    ],
    "company_size": [
      "<string>"
    ],
    "total_results": 123,
    "results_per_page": 123,
    "start_page": 123,
    "end_page": 123
  }
}
'
{
  "success": true,
  "data": {
    "companies": [
      {
        "name": "AI Solutions Inc.",
        "linkedin_url": "https://www.linkedin.com/company/ai-solutions-inc",
        "headline": "Building the future of AI",
        "location": "San Francisco, CA",
        "industry": "Artificial Intelligence",
        "company_size": "51-200",
        "logo_url": "https://media.licdn.com/dms/image/company-logo.jpg"
      },
      {
        "name": "DeepTech Labs",
        "linkedin_url": "https://www.linkedin.com/company/deeptech-labs",
        "headline": "Deep learning research and applications",
        "location": "San Francisco, CA",
        "industry": "Computer Software",
        "company_size": "11-50",
        "logo_url": "https://media.licdn.com/dms/image/company-logo2.jpg"
      }
    ],
    "total_results": 2,
    "total_available_results": 840
  },
  "metadata": {
    "action": "search_companies",
    "account_id": "your-account-id",
    "credits_consumed": 2,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Overview

Search for company pages using keyword, location, sector, and size filters. Supports pagination for retrieving large result sets.
This endpoint consumes 1 credit per 10 results returned.

Request

x-api-key
string
required
Your API key for authentication.
account_id
string
required
The unique identifier of the account to use.
action
string
required
Must be "search_companies".
params
object

Response

success
boolean
Indicates whether the request was successful.
data
object
metadata
object
{
  "success": true,
  "data": {
    "companies": [
      {
        "name": "AI Solutions Inc.",
        "linkedin_url": "https://www.linkedin.com/company/ai-solutions-inc",
        "headline": "Building the future of AI",
        "location": "San Francisco, CA",
        "industry": "Artificial Intelligence",
        "company_size": "51-200",
        "logo_url": "https://media.licdn.com/dms/image/company-logo.jpg"
      },
      {
        "name": "DeepTech Labs",
        "linkedin_url": "https://www.linkedin.com/company/deeptech-labs",
        "headline": "Deep learning research and applications",
        "location": "San Francisco, CA",
        "industry": "Computer Software",
        "company_size": "11-50",
        "logo_url": "https://media.licdn.com/dms/image/company-logo2.jpg"
      }
    ],
    "total_results": 2,
    "total_available_results": 840
  },
  "metadata": {
    "action": "search_companies",
    "account_id": "your-account-id",
    "credits_consumed": 2,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}