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

# Get Brands By Domain

> Discover brands that advertise from a given domain. Returns brand records including the Foreplay `brand_id` and the `ad_library_id` (page_id). Use the returned `ad_library_id` as the `id` input to `brand/analytics`.

Billed $0.02625 per item returned in `data[]` (1 credit per item); empty results and 4xx/5xx errors are not charged.



## OpenAPI

````yaml openapi/zh/foreplay.json GET /apis/v1/foreplay/brand/getBrandsByDomain
openapi: 3.1.0
info:
  description: ''
  title: foreplay
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/foreplay/brand/analytics
    - /apis/v1/foreplay/brand/getAdsByBrandId
    - /apis/v1/foreplay/brand/getBrandsByDomain
    - /apis/v1/foreplay/discovery/ads
  x-aisa-document:
    facts_hash: 45ce32b5d2de49bb641c368c8d52e3cc198d5f8fd4d550b370b8c779bbf9f41e
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:127fa77e132696034d322cbb9cdac88d3512ed201b72998f687dde3a2766f106
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: foreplay
  x-aisa-catalogs:
    foreplay:
      title: foreplay
      description: ''
      x-aisa-document:
        facts_hash: 45ce32b5d2de49bb641c368c8d52e3cc198d5f8fd4d550b370b8c779bbf9f41e
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/foreplay/brand/getBrandsByDomain:
    get:
      tags:
        - foreplay
      summary: Get Brands By Domain
      description: >-
        Discover brands that advertise from a given domain. Returns brand
        records including the Foreplay `brand_id` and the `ad_library_id`
        (page_id). Use the returned `ad_library_id` as the `id` input to
        `brand/analytics`.


        Billed $0.02625 per item returned in `data[]` (1 credit per item); empty
        results and 4xx/5xx errors are not charged.
      operationId: get_brands_by_domain
      parameters:
        - name: domain
          in: query
          required: true
          description: >-
            Domain name to search for. This can be a full URL (e.g.,
            'https://example.com') or just the domain (e.g., 'example.com'). The
            system will automatically format and clean the domain. This endpoint
            looks up candidate brands based on the provided domain. The returned
            brands are potential matches and are not guaranteed to be
            definitively associated with the domain.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: >-
            Pagination limit (max 10). Controls the number of brands returned
            per request.
          schema:
            type: integer
            default: 10
            maximum: 10
        - name: order
          in: query
          required: false
          description: >-
            Order of results: 'most_ranked' (default) or 'least_ranked'. Sorts
            brands by relevance ranking.
          schema:
            type: string
            default: most_ranked
      responses:
        '200':
          description: >-
            JSON envelope with `metadata` and a `data[]` array of brand objects
            (each includes `brand_id` and `ad_library_id`). Each brand in
            `data[]` counts as one billed item.
          content:
            application/json:
              schema:
                type: object
              example:
                metadata:
                  success: true
                  status_code: 200
                  count: 1
                  cursor: null
                data:
                  - brand_id: bYeKOahyGopmGKMHiWit
                    ad_library_id: '15087023444'
                    name: Nike
                error: null
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

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