Skip to main content
POST
Search realtime companies

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.

sub_industries
boolean
default:false

Controls how the industries filter maps onto LinkedIn's industry taxonomy. By default (false), a selected industry also matches companies in its sub-industries. Set to true to match only the industries you specify and exclude their sub-industries, for finer sub-category targeting — for example, "Manufacturing" without "Chemicals".

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", "10 000+".

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.

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").

apply_domain_blocklist
boolean
default:true

Apply Generect's blocked-domain list, which removes staffing agencies, directories and similar low-signal records that match broad industry filters. Set to false to receive them. On by default on the company search endpoints, in both database and realtime mode; the company-leads endpoints do not apply it. In database search the exclusion happens before results_count, so the count always matches what the pages can deliver; in realtime the records are dropped after retrieval, so a page may hold fewer companies than results_count implies.

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.

num_of_followers
string[]

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

company_names
string[]

Search by specific company names or domains.

recent_activities
enum<string>[]

Recent company events to filter on.

Available options:
Funding events in past 12 months,
Senior leadership changes in last 3 months
department_headcount_growth
object

Filter by growth of a single department (e.g. {"name": "engineering", "min": 5, "max": 50}).

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.

include_total_count
boolean
default:false

Include results_count — how many companies match the filters in total, beyond the page you asked for — in the response. Without it the response carries only the page itself. The companies counterpart of the lead-search flag of the same name, and likewise an estimate rather than an exact total.

Response

Full realtime company search results

data
object

Search results.

meta
object

Operation metadata returned in every data/meta response.