Docs / Reference / List Campaigns
Campaigns

List Campaigns

Returns a paginated list of active campaigns. Filter by category, country, access status, or search by name. Sort by EPC to surface the best-performing campaigns first. Optionally request payouts in USD.

GET /pub_api/v3/campaigns read:campaigns
Query Parameters
pageoptional
integer
 Page number. Default: 1.
per_pageoptional
integer
 Results per page. Default 30, max 500.
qoptional
string
 Full-text search on campaign and merchant name via Elasticsearch (SQL fallback). When present, country_id filter is skipped.
country_idoptional
integer
 Filter by country ID. Omit to return campaigns from all countries. India = 252. Ignored when q is set.
currencyoptional
string
 Currency for payout values. Default: INR. Supported: INR, USD. Affects payout and payout_categories[].payout fields.
category_ids[]optional
integer[]
 Filter by category IDs. Repeat the param for multiple: category_ids[]=5&category_ids[]=12. Fetch the full list of category IDs and names from List Categories.
campaign_typeoptional
string
 Filter by campaign type. Must match the canonical name exactly (case-sensitive).
CPS CPC CPL CPI - Android CPI - IOS CPI - Windows
access_statusoptional
string
 Filter by your access relationship with the campaign. Omit for all campaigns.
open approved pending blocked
sortoptional
string
 Sort field. Default: name. When q is present and no sort is specified, results are ranked by relevance.
name epc_7d epc_90d created_at updated_at
orderoptional
string
 Sort direction. Default: asc.
ascdesc
access_status values in response
ValueMeaningAction
open approved_for_all No application needed. Use the tracking_url directly.
not_applied selected Requires access. Call request_access to apply.
pending waiting Application submitted. Awaiting advertiser review.
approved granted Access granted. tracking_url is live.
rejected denied Application rejected. 3-month cooldown before re-applying.
blocked restricted You cannot promote this campaign. Possible reasons: the advertiser has blocked your access at the campaign level, you are blocked on every affiliate network the campaign runs on, or it is a CPC campaign and your account does not have CPC access enabled. Contact your account manager.
Request - top campaigns by EPC 
curl https://developers.cuelinks.com/pub_api/v3/campaigns \
  -H "Authorization: Token YOUR_API_KEY" \
  -G \
  -d "sort=epc_7d&order=desc&per_page=20"
200 OK 200 
{
  "data": [
    {
      "id": 4821,
      "name": "Flipkart",
      "url": "https://www.flipkart.com",
      "domain": "flipkart.com",
      "image": "https://cdn.cuelinks.com/...",
      "payout_type": "Per Sale",
      "payout": "4.50",
      "payout_currency": "INR",
      "campaign_type": "CPS",
      "access_status": "open",
      "categories": [{
        "id": 1,
        "name": "Shopping"
      }],
      "countries": [{
        "id": 252,
        "iso": "IN",
        "name": "India"
      }],
      "reporting_type": "standard",
      "deeplink_allowed": true,
      "sub_ids_allowed": true,
      "cashback_publishers_allowed": false,
      "social_media_publishers_allowed": true,
      "missing_transactions_accepted": false,
      "cookie_duration": 30,
      "is_featured": true,
      "epc_7d": "3.21",
      "epc_90d": "2.94",
      "tracking_url": "https://clnk.in/?cid=456&...",
      "updated_at": "2026-03-20T10:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 10482,
    "total_pages": 525,
    "next_page": 2,
    "prev_page": null
  }
}
⚡
Get notified on campaign changes
Set up a Campaign Update postback in your publisher dashboard to receive real-time notifications when campaigns are approved, paused, or updated. No need to poll this endpoint for changes.
← Previous Ping