---
title: "List Advertisers"
method: GET
path: "/api/v1/advertisers"
tags: ["advertisers"]
---

# List Advertisers

`GET /api/v1/advertisers`

## Request

- Base URL: `https://api.intentlink.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.intentlink.io/api/v1/advertisers`
- Auth: HTTP bearer

List advertisers for authenticated console and portal clients.

## Query parameters

- `network` string, nullable
- `search` string, nullable
- `category_l1` string, nullable: Filter by English L1 category name (category_l1_en). AND-ed with l2.
- `category_l2` string, nullable: Filter by English L2 category name (category_l2_en). AND-ed with l1.
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- AdvertiserListResponse
  - `items` Advertiser[]
    - `id` string, required
    - `network` string, required
    - `advertiser_id` string, required
    - `advertiser_name` string, nullable
    - `status` string, required
    - `blocked` boolean
    - `blocked_globally` boolean
    - `blocked_by_user` boolean
    - `source` string, nullable
    - `platform` string, nullable
    - `country` string, nullable
    - `currency` string, nullable
    - `language` string, nullable
    - `support_region` string, nullable
    - `business_detail` object, nullable
    - `product_feed_name` string, nullable
    - `product_feed_product_count` integer, nullable
    - `product_feed_last_updated` string, date-time, nullable
    - `category_l1` string, nullable
    - `category_l1_en` string, nullable
    - `category_l2` string, nullable
    - `category_l2_en` string, nullable
    - `category_restricted` boolean
    - `category_needs_review` boolean
    - `source_category` string, nullable
    - `epc_3m` number, nullable
    - `has_product_feed` boolean, nullable
    - `last_synced_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `limit` integer, required
  - `offset` integer, required
  - `count` integer, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/intentlink/apis/affiliate-recommendation-service.md) · [All operations](https://skmtc.dev/intentlink/apis/affiliate-recommendation-service/llms.txt) · [OpenAPI document](https://skmtc.dev/intentlink/apis/affiliate-recommendation-service/revisions/95cc11d55fb6?raw)