search

Search Companies Endpoint

Recherche avancée d'entreprises avec système de filtres conditionnels.

Authentification requise: Header api_key: <your_api_key>

Format identique au people search avec opérateurs de comparaison.

Exemple de requête:

{
  "filters": {
    "op": "and",
    "conditions": [
      {"column": "country_iso_code", "type": "=", "value": "FR"},
      {"column": "employee_count", "type": ">=", "value": 50},
      {"column": "is_actively_hiring", "type": "=", "value": true},
      {"column": "category", "type": "like", "value": "SaaS"}
    ]
  },
  "offset": 0,
  "count": 25,
  "order_by": "follower_count",
  "order_direction": "desc",
  "verify_live": false
}

Colonnes directes (companies_v2):

  • name, tagline, description, domain
  • country_iso_code, city, region
  • industry, employee_count, founded_year
  • company_type, follower_count
  • page_verified, is_actively_hiring
  • employee_growth_percent, funding_stage

Colonnes lookup (tables jointes):

  • category (via company_categories)
  • investor (via company_investors)
  • office_country, office_city (via company_locations)
  • total_funding_usd, total_funding_rounds (via company_funding)
  • employee_growth_1m/6m/12m (via company_growth_stats)
  • job_title (via company_job_postings)

Tarification: 0.25 credit par company retournee (donnees de la base)

post/search/companies

Request

  • Base URL: https://api.dataforb2b.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.dataforb2b.ai/search/companies
  • Auth: none declared

Headers

X-Debug-SQLstring nullable
x-internal-secretstring nullable
api-keystring nullable

Request body

lookalike_companystring nullable

LinkedIn company URL or universal_name to find similar companies. Mutually exclusive with filters.

offsetinteger

Offset pour la pagination

countinteger

Nombre de résultats (max 1000)

order_bystring nullable

Colonne de tri (follower_count, employee_count, founded_year, etc.)

order_directionstring

Direction du tri (asc/desc)

verify_liveboolean

Verify that live data still matches filter conditions

fallback_dbboolean

Fallback to DB data if live enrichment fails. Set to False to return error instead of stale data.

exclude_billing_idsstring[] nullable

Internal (backend_app only, requires x-internal-secret): result ids already billed in a previous page of the same search, not billed again.

Response

Successful Response

totalinteger required

Total number of matching companies (estimate)

offsetinteger

Current offset

countinteger required

Number of results returned

has_next_pageboolean required

Whether there are more results available

credits_usednumber

Credits used for this search

resultsobject[] required

Company results

_debugobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.