> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Lookalikes

## Request

#### Header

<ParamField header="Accept-Language" type="string" default="EN">
  * NL: Dutch - FR: French - EN: English
</ParamField>

#### Body

<ParamField path="companies" type="array">
  <Expandable title="company properties">
    <ResponseField name="companyId" type="string" required>
      Obfuscated companyId returned by the search endpoint.
    </ResponseField>

    <ResponseField name="countryCode" type="string" required>
      Any supported country code — see [Supported countries](/api-reference/v2/supported-countries).
    </ResponseField>
  </Expandable>

  <Note>You can request up to 100 companies at once.</Note>
</ParamField>

<ParamField body="limit" type="number" default="4">
  Number of items to return per page. (max 500)
</ParamField>

<ParamField body="offset" type="number" default="0">
  Number of items to skip. `companies.length x limit` may not exceed 500.
</ParamField>

## Response

<ResponseField name="score" type="number">
  Company lookalike score. Lookalikes are sorted in descending order.
</ResponseField>

<Note>
  Offset is displayed in pagination response, but defaults to 0 due to dynamic
  scoring.
</Note>

<Note>
  The same limit and offset are shared over all companies.
</Note>

<ResponseExample>
  ```json Response - 200 theme={null}
  [
      {
          "identifier": {
              "countryCode": "BE",
              "companyId": "1778186251",
              "name": "Bizzy"
          },
          "data": {
              "lookalikes": [
                  {
                      "companyId": {
                          "countryCode": "GB",
                          "companyId": "50974991575",
                          "name": "E-horizon Systems"
                      },
                      "score": 100.970215
                  },
                  {
                      "companyId": {
                          "countryCode": "GB",
                          "companyId": "50332067174",
                          "name": "Bizko Inc"
                      },
                      "score": 100.970215
                  },
                  {
                      "companyId": {
                          "countryCode": "BE",
                          "companyId": "51222683020",
                          "name": "F.t.c."
                      },
                      "score": 100.96812
                  },
                  {
                      "companyId": {
                          "countryCode": "CH",
                          "companyId": "49427557067",
                          "name": "Salesport"
                      },
                      "score": 100.96804
                  }
              ]
          },
          "pagination": {
              "limit": 4,
              "offset": 0,
              "total": 10000
          },
          "message": null
      },
      { // Example error
          "identifier": {
              "countryCode": "BE",
              "companyId": "123",
              "name": ""
          },
          "data": null,
          "pagination": null,
          "message": "Company not found"
      }
  ]
  ```
</ResponseExample>