---
title: "Search Companies Endpoint"
method: POST
path: "/search/companies"
tags: ["search"]
---

# Search Companies Endpoint

`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

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:**
```json
{
  "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)

## Headers

- `X-Debug-SQL` string, nullable
- `x-internal-secret` string, nullable
- `api-key` string, nullable

## Request body

- AdvancedCompanySearchRequest: Requête de recherche avancée pour les companies. Utilise le même format FilterGroup que people search.
  - `filters` FilterGroup: Group of filters with AND/OR logic Can contain FilterCondition or nested FilterGroup
    - `op` 'and' | 'or': Logical operator
    - `conditions` union[]
      - union
        - FilterCondition: Single filter condition Operators: - "=", "!=" : Equality - ">", ">=", "<", "<=" : Numeric comparison - "in", "not_in" : List membership - "like", "not_like" : Text search (case-insensitive) - "is_null", "is_not_null" : Null checks - "between" : Range (requires value and value2)
          - `column` string, required: Column name to filter on
          - `type` '=' | '!=' | '>' | '>=' | '<' | '<=' | 'in' | 'not_in' | 'like' | 'not_like' | 'is_null' | 'is_not_null' | 'between' | 'regex', required
          - `value` unknown
          - `value2` unknown
        - FilterGroup (recursive)
  - `lookalike_company` string, nullable: LinkedIn company URL or universal_name to find similar companies. Mutually exclusive with filters.
  - `offset` integer: Offset pour la pagination
  - `count` integer: Nombre de résultats (max 1000)
  - `order_by` string, nullable: Colonne de tri (follower_count, employee_count, founded_year, etc.)
  - `order_direction` string: Direction du tri (asc/desc)
  - `verify_live` boolean: Verify that live data still matches filter conditions
  - `fallback_db` boolean: Fallback to DB data if live enrichment fails. Set to False to return error instead of stale data.
  - `exclude_billing_ids` string[], 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 `200`

Successful Response

- CompanySearchResponse: Réponse de recherche companies
  - `total` integer, required: Total number of matching companies (estimate)
  - `offset` integer: Current offset
  - `count` integer, required: Number of results returned
  - `has_next_page` boolean, required: Whether there are more results available
  - `credits_used` number: Credits used for this search
  - `results` object[], required: Company results
  - `_debug` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dataforb2b/apis/dataforb2b-api.md) · [All operations](https://skmtc.dev/dataforb2b/apis/dataforb2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataforb2b/apis/dataforb2b-api/revisions/24ea79caa1a1?raw)