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

# Search Advertisers

> Look up TikTok advertiser business ids by name, then feed the id into the Ad Library search to list every ad an advertiser runs.

<Note>
  The TikTok Ad Library is **EU-only** (EU Digital Services Act ad transparency).
  Use an EU `region` such as `DE`, `FR`, `IE`, or `NL`.
</Note>

<Note>
  Matching is on the **legal entity name, not the brand**. Searching `nike`
  returns entities like `NIKE Retail B.V.` and `NIKE COM SRL` — a brand often
  spans several legal entities, and some are only discoverable via an ad's
  `advertiser.adv_biz_ids` on [Get Ad Detail](/api-reference/endpoint/tiktok/get-ad-detail).
</Note>

<Note>
  Each request costs **5 credits**. Failed requests are not charged.
</Note>

<Tip>
  Full workflow: **Search Advertisers** (`?query=Nike`) → take an advertiser `id`
  → [Search the Ad Library](/api-reference/endpoint/tiktok/search-ads)
  (`?advertiser_id=<id>`) → take an ad `id` →
  [Get Ad Detail](/api-reference/endpoint/tiktok/get-ad-detail).
</Tip>


## OpenAPI

````yaml GET /v1/tiktok/ads/advertisers
openapi: 3.1.0
info:
  title: ScrapeBadger TikTok API
  version: 1.0.0
  description: >-
    TikTok scraping API for user profiles, videos, comments, transcripts,
    hashtags, music/sounds, search, trending, and the EU Commercial Content (ad
    transparency) library. Returns clean structured JSON; handles signing,
    anti-bot bypass, and regional proxy routing automatically.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/tiktok/ads/advertisers:
    get:
      tags:
        - TikTok Ads
      summary: Search TikTok advertisers
      description: >-
        Look up advertiser business ids by name in TikTok's EU Ad Library.
        Matching is on the legal entity name, not the brand.
      operationId: searchTikTokAdvertisers
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
            minLength: 1
          description: Advertiser name (or partial) to look up.
        - name: region
          in: query
          schema:
            type: string
            default: DE
          description: EU region code — the Ad Library is EU-only.
        - name: count
          in: query
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 50
          description: Maximum number of suggestions.
      responses:
        '200':
          description: Matching advertisers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdvertiserSearchResponse'
              example:
                advertisers:
                  - name: NIKE COM SRL
                    id: '7587573238117498896'
                  - name: NIKE Retail B.V.
                    id: '6876453864464188162'
                keywords: []
                query: nike
                region: DE
components:
  schemas:
    AdvertiserSearchResponse:
      type: object
      properties:
        advertisers:
          type: array
          items:
            $ref: '#/components/schemas/AdvertiserSuggestion'
        keywords:
          type: array
          items:
            type: string
          description: Ad-keyword suggestions, when present.
        query:
          type: string
        region:
          type: string
      required:
        - query
        - region
    AdvertiserSuggestion:
      type: object
      properties:
        name:
          type: string
          description: Advertiser legal entity name.
        id:
          type: string
          description: Advertiser business id — pass as advertiser_id to ads/search.
      description: One advertiser match.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````