> ## Documentation Index > Fetch the complete documentation index at: https://docs.aitasker.co/llms.txt > Use this file to discover all available pages before exploring further. # List Global Ad Library Advertisers > Distinct advertisers (brands) across the global ad library. Powers the Explore Brands tab — a server-side ``GROUP BY advertiser_id`` aggregate so every brand surfaces (paginated), not just the handful that dominate a single ad-fetch page. Same filter semantics as ``/search``. ## OpenAPI ````yaml /openapi.json get /api/v1/ad-library/advertisers openapi: 3.1.0 info: title: AITasker version: 0.1.0 servers: [] security: [] paths: /api/v1/ad-library/advertisers: get: tags: - Ad Library - Ad Library summary: List Global Ad Library Advertisers description: |- Distinct advertisers (brands) across the global ad library. Powers the Explore Brands tab — a server-side ``GROUP BY advertiser_id`` aggregate so every brand surfaces (paginated), not just the handful that dominate a single ad-fetch page. Same filter semantics as ``/search``. operationId: list_global_ad_library_advertisers_api_v1_ad_library_advertisers_get parameters: - name: q in: query required: false schema: anyOf: - type: string maxLength: 200 minLength: 1 - type: 'null' title: Q - name: provider in: query required: false schema: anyOf: - type: string minLength: 1 maxLength: 80 - type: 'null' title: Provider - name: platform in: query required: false schema: anyOf: - type: string maxLength: 200 minLength: 1 - type: 'null' title: Platform - name: review_platform in: query required: false schema: anyOf: - type: string enum: - trustpilot - google - type: 'null' title: Review Platform - name: has_reviews in: query required: false schema: type: boolean default: false title: Has Reviews - name: sort in: query required: false schema: anyOf: - type: string maxLength: 40 minLength: 1 - type: 'null' title: Sort - name: recommendation_industry in: query required: false schema: anyOf: - type: string maxLength: 120 minLength: 1 - type: 'null' title: Recommendation Industry - name: country in: query required: false schema: anyOf: - type: string minLength: 2 maxLength: 1000 - type: 'null' title: Country - name: language in: query required: false schema: anyOf: - type: string minLength: 2 maxLength: 1000 - type: 'null' title: Language - name: status in: query required: false schema: anyOf: - type: string maxLength: 200 minLength: 1 - type: 'null' title: Status - name: creative_type in: query required: false schema: anyOf: - type: string maxLength: 200 minLength: 1 - type: 'null' title: Creative Type - name: video_length in: query required: false schema: anyOf: - type: string maxLength: 200 minLength: 1 - type: 'null' title: Video Length - name: industry in: query required: false schema: anyOf: - type: string maxLength: 1000 minLength: 1 - type: 'null' title: Industry - name: brand_industry in: query required: false schema: anyOf: - type: string maxLength: 1000 minLength: 1 - type: 'null' title: Brand Industry - name: business_model in: query required: false schema: anyOf: - type: string minLength: 1 maxLength: 400 - type: 'null' title: Business Model - name: theme in: query required: false schema: anyOf: - type: string minLength: 1 maxLength: 600 - type: 'null' title: Theme - name: activity in: query required: false schema: anyOf: - type: string maxLength: 200 minLength: 1 - type: 'null' title: Activity - name: seen_since in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Seen Since - name: seen_until in: query required: false schema: anyOf: - type: string format: date-time - type: 'null' title: Seen Until - name: limit in: query required: false schema: type: integer minimum: 1 default: 50 title: Limit - name: offset in: query required: false schema: type: integer minimum: 0 title: Offset default: 0 responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AdLibraryAdvertiserListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: AdLibraryAdvertiserListResponse: properties: generated_at: type: string format: date-time title: Generated At total: type: integer title: Total default: 0 limit: type: integer title: Limit offset: type: integer title: Offset has_more: type: boolean title: Has More default: false items: items: $ref: '#/components/schemas/AdLibraryAdvertiserListItem' type: array title: Items type: object required: - generated_at - limit - offset title: AdLibraryAdvertiserListResponse description: >- Paginated advertiser (brand) list for the Explore Brands tab. ``total`` is the distinct advertiser count for the current filters (drives ``has_more`` / "Load more"); no brand scope — Explore browses the complete ad library. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError AdLibraryAdvertiserListItem: properties: advertiser: $ref: '#/components/schemas/AdLibraryAdvertiserSummary' total_ads: type: integer title: Total Ads default: 0 review_count: type: integer title: Review Count default: 0 new_ads_30d: type: integer title: New Ads 30D default: 0 active_ads: type: integer title: Active Ads default: 0 industry_match: type: boolean title: Industry Match default: false recommendation_score: type: number maximum: 100 minimum: 0 title: Recommendation Score default: 0 last_active_at: anyOf: - type: string format: date-time - type: 'null' title: Last Active At platforms: items: type: string type: array title: Platforms providers: items: type: string type: array title: Providers countries: items: type: string type: array title: Countries type: object required: - advertiser title: AdLibraryAdvertiserListItem description: >- One advertiser (brand) row for the Explore Brands list. Server-side ``GROUP BY advertiser_id`` aggregate over the global ad library — accurate ad counts regardless of how many ads a single fetch page would carry. ``platforms`` / ``providers`` are the distinct stored values across the advertiser's matching ads (Facebook / Instagram / WhatsApp surfaces are split from Meta publisher_platforms), so the row badges agree with the Explore feed. ``countries`` is the distinct observation country set for those matching ads. Recommendation evidence is returned alongside the score so the UI can explain it: actual launches in 30 days, active inventory, portfolio size, and selected-industry match. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError AdLibraryAdvertiserSummary: properties: id: anyOf: - type: string format: uuid - type: 'null' title: Id name: anyOf: - type: string - type: 'null' title: Name parent_company: anyOf: - $ref: '#/components/schemas/AdLibraryOrgSummary' - type: 'null' primary_domain: anyOf: - type: string - type: 'null' title: Primary Domain website_url: anyOf: - type: string - type: 'null' title: Website Url website_header_image_url: anyOf: - type: string - type: 'null' title: Website Header Image Url industry: anyOf: - type: string - type: 'null' title: Industry brand_classification: anyOf: - $ref: '#/components/schemas/BrandClassification' - type: 'null' partners: items: $ref: '#/components/schemas/AdLibraryPartnerSummary' type: array title: Partners type: object title: AdLibraryAdvertiserSummary AdLibraryOrgSummary: properties: id: type: string format: uuid title: Id name: type: string title: Name type: object required: - id - name title: AdLibraryOrgSummary description: A parent company or paying agency, by id + display name. BrandClassification: properties: primary_industry: anyOf: - type: string - type: 'null' title: Primary Industry industries: items: type: string type: array title: Industries business_models: items: type: string type: array title: Business Models version: anyOf: - type: string - type: 'null' title: Version source: anyOf: - type: string - type: 'null' title: Source classified_at: anyOf: - type: string format: date-time - type: 'null' title: Classified At needs_review: type: boolean title: Needs Review default: false type: object title: BrandClassification description: >- A versioned multi-label brand classification. Industries describe what the brand sells or does. Business models describe how it operates independently of industry. Keeping those dimensions separate prevents the historical ``E-Commerce`` pseudo-industry from replacing the brand's real product industry. AdLibraryPartnerSummary: properties: name: type: string title: Name page_id: anyOf: - type: string - type: 'null' title: Page Id page_url: anyOf: - type: string - type: 'null' title: Page Url profile_image_url: anyOf: - type: string - type: 'null' title: Profile Image Url type: object required: - name title: AdLibraryPartnerSummary securitySchemes: HTTPBearer: type: http scheme: bearer ````