Metrics

Campaign creative daily metrics

One row per day and current Meta ad creative: spend_media, impressions, followers, and cpf. spend_media excludes fees. cpf is spend_media / followers for that row, and null when followers is zero. Across days, divide summed spend by summed followers.

Separate from the lifetime creatives endpoint, which groups by background video and rejects dates. Each ad is counted once, from its latest smartlink row.

startDate and endDate are optional and inclusive. Omit both for every day that has rows. Ordered by date, then creative id.

Requires the metrics:read scope. Accepts API key or OAuth Bearer.

GET

campaigns

{campaignId}

metrics

creative-daily

Campaign creative daily metrics

curl --request GET \
  --url https://api.getsoundlink.com/v1/campaigns/{campaignId}/metrics/creative-daily \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.getsoundlink.com/v1/campaigns/{campaignId}/metrics/creative-daily"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/campaigns/{campaignId}/metrics/creative-daily', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "date": "2026-03-01",
        "meta_ad_creative_id": "1234567890",
        "spend_media": 40,
        "impressions": 400,
        "followers": 4,
        "cpf": 10
      },
      {
        "date": "2026-03-02",
        "meta_ad_creative_id": "1234567890",
        "spend_media": 10.5,
        "impressions": 100,
        "followers": 0,
        "cpf": null
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 50,
      "totalCount": 2,
      "totalPages": 1
    }
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Authorizations

Authorization

string

header

required

Pass your Soundlink sk_* API key as a Bearer token: Authorization: Bearer sk_<prefix>_<token> (not an OAuth token; see oauthBearer for that). Accepted on all Public API operations. Send only one Authorization header per request.

Path Parameters

campaignId

string

required

Campaign identifier (UUID)

Query Parameters

startDate

string<date>

Inclusive start date (YYYY-MM-DD). Omit to include every day from the first row.

endDate

string<date>

Inclusive end date (YYYY-MM-DD). Omit to include every day through the latest row.

page

integer

default:1

Page number (1-indexed)

Required range: x >= 1

pageSize

integer

default:50

Rows per page (max 500; higher default than list endpoints)

Required range: 1 <= x <= 500

Response

Daily creative rows for the campaign

data

object

required

Show child attributes

meta

object

required

Show child attributes

Campaign creative daily metrics

curl --request GET \
  --url https://api.getsoundlink.com/v1/campaigns/{campaignId}/metrics/creative-daily \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.getsoundlink.com/v1/campaigns/{campaignId}/metrics/creative-daily"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/campaigns/{campaignId}/metrics/creative-daily', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "date": "2026-03-01",
        "meta_ad_creative_id": "1234567890",
        "spend_media": 40,
        "impressions": 400,
        "followers": 4,
        "cpf": 10
      },
      {
        "date": "2026-03-02",
        "meta_ad_creative_id": "1234567890",
        "spend_media": 10.5,
        "impressions": 100,
        "followers": 0,
        "cpf": null
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 50,
      "totalCount": 2,
      "totalPages": 1
    }
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

System

Wallet

Campaigns

Soundlinks

Videos

Campaign creative daily metrics

Authorizations

Path Parameters

Query Parameters

Response