List media eligibility scores - Grade SDK API

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.