Skip to main content
POST

Credit Cost


Request Body

object
Filter group to apply to the search. See Filters section below.
string
required
Logical operator to combine conditions.
  • and - All conditions must match
  • or - At least one condition must match
array
required
Array of filter conditions or nested filter groups.
string
required
Column name to filter on. See Available Columns section below for complete list with data types and recommended operators.Basic Info: name, tagline, description, domain, universal_name, keyword, industrySize: employee_count (ranges: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+)Headquarters: country_iso_code (ISO 2 letters like “US”, “FR”, “GB”), city, regionOffices: office_country, office_city, office_regionGrowth: employee_growth_1m, employee_growth_6m, employee_growth_12m, recent_hires_countMetadata: founded_year, company_type, follower_count, page_verified, categoryFunding: last_funding_amount_usd, last_funding_date, funding_stage_normalized, has_funding
string
required
Comparison operator to use. Available operators:
  • = - Exact match
  • > - Greater than
  • >= - Greater than or equal
  • < - Less than
  • <= - Less than or equal
  • between - Between two values (requires value2)
  • in - Value is in a list
  • like - Text search (pattern matching)
any
Filter value to compare against.
any
Second value (only used with between operator).
integer
default:"0"
Number of results to skip for pagination.
integer
default:"25"
Number of results to return. Maximum: 1000.
boolean
default:"true"
Whether to enrich companies with live data.
  • true - Returns fresh, up-to-date data (1.5 credits per result)
  • false - Returns cached data (0.75 credits per result)

Filters System

FilterGroup Structure

A FilterGroup combines multiple conditions with a logical operator:

FilterCondition Structure

Available Operators

How text matching works

The operator controls how text is matched — there are no separator characters (comma, pipe, etc.):
  • = matches the exact value, case-insensitive. On multi-word fields it matches the full phrase, in order — name = "OpenAI" is exact.
  • like matches records where all the words appear, in any order — the best choice for partial or keyword search. keyword like "artificial intelligence" matches any company whose name, tagline or description contains both words.
  • in takes a JSON array and matches any value in it (OR): "value": ["FR", "US"]. A comma-separated string like "FR,US" is treated as a single literal value and returns nothing — always pass an array.

Available Columns

Basic Info

Size

Headquarters

Offices

Growth

Metadata

Funding


Complex Query Examples


Response

integer
Total number of results matching the filters.
integer
Offset used for pagination.
integer
Number of results returned in this response.
array
List of companies matching the filters. Each company contains the fields specified by the search columns.