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

# Search lookalike companies

> Synchronous. Returns companies similar to the given domains (1-10), one page at a time (page from 1 and pageSize 1-100, both required), filtered by locations, employee ranges, funding stages and categories.

Consumes credits: your account's lookalike price per company returned. The request reserves the price for a full page and charges only the companies actually returned; the rest is released. Use POST /lookalikes/preview to tune filters first; previews are free up to a monthly allowance, then each costs a fixed price per call.

To find and enrich people at these companies, pass a returned company domain into POST /search companyDomains.include to get personIDs, then send those to the /enrichment endpoints.

Idempotency-Key: keys are remembered for 10 minutes per account. Within that window a retried request with the same key returns the original result without charging again, whatever its body as long as it is valid, and a retry while the first request is still running returns 409; after it, a retry is a new, charged request. Use a new key for each distinct request, including each page. A request that fails frees its key.



## OpenAPI

````yaml https://api.leadsforge.ai/public/swagger/doc.json post /lookalikes/search
openapi: 3.1.0
info:
  description: >-
    Search B2B leads, find their work emails, phone numbers and LinkedIn
    profiles, and discover lookalike companies, company page followers and local
    businesses.


    Authenticate every request with your API key in the `Authorization` header:
    the raw key, no `Bearer` prefix. Create the key in the Leadsforge app under
    Settings -> API & MCP.


    Paid operations consume credits from your account balance, and each
    operation says whether it is paid. Long-running operations are asynchronous:
    they return a job that you poll (or receive by webhook) and then page
    through its results.


    Errors return a JSON body with a human-readable `message` and, except for an
    unknown path (404), a stable `code`. Program against `code`. A JSON body
    with a field the operation does not accept is rejected with 400 bad_request,
    listing the unknown fields in data.validations. A request still running when
    the server timeout is reached is cut off with 503 and an empty body.
  license:
    name: Proprietary
    url: https://www.leadsforge.ai/terms
  termsOfService: https://www.leadsforge.ai/terms
  title: Leadsforge API
  version: '1.0'
servers:
  - url: https://api.leadsforge.ai/public/v1
security: []
tags:
  - description: Your account's credit balance.
    name: Balance
  - description: >-
      Find people by role, seniority, company, location and other filters.
      Searches and counts are free up to a monthly allowance, then each one
      costs credits; finding contact details is charged separately.
    name: Search
  - description: >-
      Accepted values for the controlled filters of POST /search and POST
      /search/count, and a resolver for location strings. All free.
    name: Search filters
  - description: >-
      Find work emails, phone numbers and LinkedIn profiles. Asynchronous jobs
      take up to 500 people; synchronous calls take one person and answer in the
      same response.
    name: Enrichment
  - description: >-
      Find companies similar to the domains you give. Previews are free up to a
      monthly allowance, then each one costs credits; the search consumes
      credits per company returned.
    name: Lookalikes
  - description: >-
      Find the people who follow a LinkedIn company page. Asynchronous jobs that
      consume credits per follower collected.
    name: Company followers
  - description: >-
      Find local businesses in an area you choose, then find their owners'
      emails and phone numbers. Both steps are asynchronous jobs that consume
      credits.
    name: Maps discovery
  - description: Scrape LinkedIn Sales Navigator searches.
    name: salesnav
externalDocs:
  description: Leadsforge API guides
  url: >-
    https://developer.salesforge.ai/leadsforge-api/concepts/search-and-enrichment
paths:
  /lookalikes/search:
    post:
      tags:
        - Lookalikes
      summary: Search lookalike companies
      description: >-
        Synchronous. Returns companies similar to the given domains (1-10), one
        page at a time (page from 1 and pageSize 1-100, both required), filtered
        by locations, employee ranges, funding stages and categories.


        Consumes credits: your account's lookalike price per company returned.
        The request reserves the price for a full page and charges only the
        companies actually returned; the rest is released. Use POST
        /lookalikes/preview to tune filters first; previews are free up to a
        monthly allowance, then each costs a fixed price per call.


        To find and enrich people at these companies, pass a returned company
        domain into POST /search companyDomains.include to get personIDs, then
        send those to the /enrichment endpoints.


        Idempotency-Key: keys are remembered for 10 minutes per account. Within
        that window a retried request with the same key returns the original
        result without charging again, whatever its body as long as it is valid,
        and a retry while the first request is still running returns 409; after
        it, a retry is a new, charged request. Use a new key for each distinct
        request, including each page. A request that fails frees its key.
      operationId: searchLookalikes
      parameters:
        - description: >-
            Idempotency key - remembered for 10 minutes per account; a retry
            with the same key returns the original result without charging
            credits again. Use a new key for each distinct request
          in: header
          name: Idempotency-Key
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LookalikesSearchRequest'
              description: Search request
              summary: body
        description: Search request
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookalikesSearchResponse'
          description: Search results
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: 'bad_request: the body or a parameter is invalid'
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            missing_api_key, invalid_api_key, or unauthorized when your account
            is blocked
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            insufficient_credits: the balance does not cover the credits this
            request reserves
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            account_frozen: credit spending is paused for your account; contact
            support
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            idempotency_conflict: a request with this Idempotency-Key is still
            in progress
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            rate_limited: too many requests, retry later; Retry-After is set
            when known
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: >-
            internal: unexpected or temporary server error; nothing is charged,
            safe to retry
        '502':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: 'bad_gateway: a temporary error, retry later'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    LookalikesSearchRequest:
      properties:
        categories:
          description: >-
            One of b2b, b2c, b2g, ecommerce, media, service-provider, mobile,
            saas.
          example:
            - b2b
            - saas
          items:
            type: string
          type: array
          uniqueItems: false
        domains:
          description: Company domains without scheme or path, e.g. salesforge.ai.
          example:
            - salesforge.ai
          items:
            type: string
          maxItems: 10
          minItems: 1
          type: array
          uniqueItems: false
        employeeRanges:
          description: Values from GET /lookalikes/filters/employee-ranges.
          example:
            - 11-50
            - 51-200
          items:
            type: string
          type: array
          uniqueItems: false
        fundingStages:
          description: >-
            One of seed, angel, venture, debt_financing, series_a ... series_h,
            other.
          example:
            - seed
            - series_a
          items:
            type: string
          type: array
          uniqueItems: false
        locations:
          description: Country codes and region IDs from GET /lookalikes/filters/locations.
          items:
            $ref: '#/components/schemas/CompanyLookalikesLocation'
          type: array
          uniqueItems: false
        page:
          example: 1
          minimum: 1
          type: integer
        pageSize:
          example: 25
          maximum: 100
          minimum: 1
          type: integer
      required:
        - domains
        - page
        - pageSize
      type: object
    LookalikesSearchResponse:
      properties:
        companies:
          items:
            $ref: '#/components/schemas/LookalikeCompany'
          type: array
          uniqueItems: false
        page:
          type: integer
        totalCount:
          type: integer
        totalPages:
          type: integer
      type: object
    ApiError:
      properties:
        code:
          description: >-
            Code is the stable, machine-readable error code; each endpoint lists
            the codes it returns.
          type: string
        data:
          description: >-
            Data carries details for some errors; on validation errors it is
            {"validations": ["..."]}, one message per

            invalid field.
        message:
          type: string
      type: object
    CompanyLookalikesLocation:
      properties:
        id:
          example: US
          type: string
        type:
          enum:
            - country
            - region
          example: country
          type: string
      required:
        - id
        - type
      type: object
    LookalikeCompany:
      properties:
        description:
          type: string
        domain:
          type: string
        industry:
          type: string
        keywords:
          items:
            type: string
          type: array
          uniqueItems: false
        logo:
          type: string
        name:
          type: string
        website:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: >-
        Your API key, sent as is (no `Bearer` prefix). Create it in the
        Leadsforge app under Settings -> API & MCP.
      in: header
      name: Authorization
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.