POST
/
search
/
realtime
/
companies
Search realtime companies
curl --request POST \
  --url https://api.generect.com/api/v1/search/realtime/companies/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "industries": [
    "Software"
  ],
  "headcounts": [
    "51-200"
  ],
  "locations": [
    "United States"
  ],
  "limit_by": 50
}
'
{
  "data": {
    "companies": [
      {
        "linkedin_id": "1035",
        "name": "Microsoft",
        "domain": "microsoft.com"
      }
    ],
    "results_count": 530
  },
  "meta": {
    "amount_charged": 21.2
  }
}

Use Case:

Search fresh company data with full realtime filters.

Pricing

This is a billable endpoint — you are charged for each result returned. If no results are found, the request is free.
Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →

Authorizations

Authorization
string
header
required

Use the required Token prefix. Example: Authorization: Token xxxxxxxxx

Body

application/json
industries
string[]

Industries of the target companies; a company is included if it matches at least one. Values follow LinkedIn's industry taxonomy. Examples: "Software Development", "Financial Services", "Information Technology".

exclude_industries
string[]

Industries to exclude.

headcounts
string[]

Company size, as employee-count ranges; a company is included if it falls into at least one. Allowed values: "1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10000", "10001+".

locations
string[]

Company headquarters locations — matches across cities, states/regions and countries; a company is included if its HQ matches at least one. Examples: "United States", "San Francisco, California, United States", "Germany".

exclude_locations
string[]

Locations to exclude.

company_types
string[]

Company types: "Public Company", "Privately Held", "Non Profit", "Government Agency", "Educational", etc.

num_of_followers
string[]

Follower count ranges: "1-50", "51-100", "101-1000", "1001-5000", "5001+".

keywords
string[]

Free-text keywords matched across company profiles (name, description, specialties); a company is included if it contains at least one. OR logic, max 10 keywords, up to 40 characters each. Examples: "platform", "marketplace", "developer tools".

technologies
string[]

Technologies used by the company.

company_names
string[]

Search by specific company names.

exclude_ids
string[]

Exclude companies by LinkedIn ID or URN.

exclude_domains
string[]

Exclude companies by domain.

limit_by
integer

Maximum number of companies to return (1-1600).

offset_by
integer

Number of companies to skip (0-1599, for pagination).

strict
string[]

Fields to apply strict matching on (e.g. "company_locations").

revenues_range
object

Revenue filter with min/max (e.g. {"min": 1000000, "max": 50000000}).

department_headcount
object

Filter by department size (e.g. {"name": "engineering", "min": 10, "max": 100}).

headcount_growth
object

Filter by headcount growth percentage (e.g. {"min": 5, "max": 50}).

hiring_on_linkedin
boolean
default:false

Filter for companies actively hiring on LinkedIn.

Filter by specific LinkedIn company URLs.

Response

Full realtime company search results

data
object

Search results.

meta
object

Operation metadata returned in every data/meta response.