Documentation / Campaign management / Media eligibility

List media eligibility scores

List tracked campaign posts and their current eligibility scores.

list media eligibility scores · bash
curl -sS "$BASE_URL/sdk/v1/campaign-media/eligibility-scores?campaignId=camp_123&page=1&limit=500" \
  -H "X-Application-Id: $APP_ID" \
  -H "X-Api-Key: $API_KEY"
All documentation

GET /sdk/v1/campaign-media/eligibility-scores

Lists tracked campaign posts and their eligibility scores. Account-tracking rows are not included.

All requests require X-Application-Id and X-Api-Key.

Query parameters

  • campaignId (optional): limit results to one campaign.
  • page (optional): page number, starting at 1. Default: 1.
  • limit (optional): posts per page. Default: 100; maximum: 500.

Example request

curl -sS "$BASE_URL/sdk/v1/campaign-media/eligibility-scores?campaignId=camp_123&page=1&limit=500" \
  -H "X-Application-Id: $APP_ID" \
  -H "X-Api-Key: $API_KEY"

Response

score is null when no score has been provided yet.

{
  "success": true,
  "data": [
    {
      "campaignCreatorMediaId": "CCMEDIA_123",
      "campaignCreatorRecordId": "CCR_123",
      "campaignId": "camp_123",
      "url": "https://www.tiktok.com/@jordan/video/123",
      "platform": "TIKTOK",
      "score": 82.5
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 500,
    "total": 1,
    "totalPages": 1
  }
}

Common errors

  • 400: invalid pagination or a limit greater than 500
  • 401: missing or invalid SDK credentials

Use campaignCreatorMediaId with Update media eligibility scores.

Describe your program.

Grade turns it into a program it can track and pay.