Skip to main content
POST
Search Companies

Description

This endpoint allows you to search company pages using various advanced filtering criteria.
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
Enrichment (if enrich: true): +1 credit per company

Headers

string
required
Your API key for authentication

Body Parameters

string
required
Keyword to search for (company name, industry, etc.)
string or array
Industry sector(s) (e.g., “technology” or [“technology”, “finance”, “healthcare”])
string or array
Location(s) (e.g., “Paris” or [“Paris”, “Lyon”, “Marseille”])
string or array
Employee range(s) (e.g., “1-50” or [“1-50”, “51-200”, “201-1000”])
integer
default:"10"
Number of results to return
  • Minimum: 1
  • Maximum: 50,000
  • Default: 10
boolean
default:"false"
Retrieve enriched company data with detailed informationWhen set to true, returns comprehensive company details including:
  • Complete company profile information
  • Employee count and ranges
  • Headquarters and locations
  • Logo and cover images
  • Funding information
  • Organization type
  • And more…
Default: false (returns basic information only)

Response

string
Response status (“success” or “error”)
object
string
Error message (if status = “error”)

Important Notes

  • Credit consumption is based on the number of results: 1 credit for 1-10 results, 2 credits for 11-20 results, etc.
  • Credits are only deducted on successful searches