API resource

Metrics

One read API over everything that is synced: posts (published through Creator OS or directly on the network), accounts, inbox activity and, with the Ads add-on, ads, campaigns and ad accounts, by id, day by day, as a list or grouped. GET /v1/metrics/catalog lists every entity, field, filter and grouping. The platform queries run a native Meta, Google Ads or TikTok Ads report on one ad account and return its rows unchanged.

List the metrics, groupings and limits of each metrics endpoint

GET/v1/metrics/catalog

Works on: Every network

Describes each metrics endpoint (GET /v1/metrics/posts, /accounts, /insights, /inbox, /ads, /campaigns and /ad-accounts): the scope it needs, the most ids per scope, the longest and default date window, the granularities, sorts, includes, groupBy values, attributions and every metric with its unit, platforms and freshness. Read it once and cache it: it changes only when Creator OS adds a metric or a grouping. Filter with entity and platform to get only what one screen needs. No analytics add-on is needed to read it.

Query parameters

entitystring

Only this entity. One of: posts, accounts, inbox, insights, ads, campaigns, ad-accounts.

platformstring

Only the metrics, sorts, includes and groupBy values this platform has. Every entity is still listed. One of: tiktok, instagram, facebook, youtube, linkedin, twitter, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat, whatsapp, discord, slack, google, microsoft, openai.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/catalog" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "entity": "posts",
      "path": "string",
      "requiredScope": [
        "string"
      ],
      "maxScopeIds": {},
      "maxRangeDays": 0,
      "defaultRangeDays": "string",
      "granularities": [
        "total"
      ],
      "sorts": [
        "string"
      ],
      "maxSortedRows": "string",
      "includes": [
        {}
      ],
      "groupBy": [
        {}
      ],
      "attributions": [
        {}
      ],
      "origins": [
        "string"
      ],
      "metrics": [
        {}
      ]
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

Read post metrics by id, day by day, as a list, or grouped

GET/v1/metrics/posts

Works on: Every network

Reads the metrics Creator OS synced for published posts, Creator OS posts and posts published outside Creator OS alike. Send exactly one scope: postId, platformPostId, accountId or profileId, or read the change feed with changedSince. - By id (postId or platformPostId, up to 100): one row per publication. Ids that match no post you can read come back in meta.missingIds. - One post day by day: one id with granularity=day. - A list (accountId up to 25, or one profileId with an optional platform): posts published in the window, newest first, paged with cursor.

Query parameters

postIdstring

Comma-separated post ids (Creator OS or external), up to 100.

platformPostIdstring

Comma-separated ids the platform gave the posts (a TikTok video id, a tweet id), up to 100.

accountIdstring

Comma-separated account ids, up to 25.

metricsstring

Comma-separated metric names from the catalog. Defaults to every metric.

groupBystring

Comma-separated groupings from the catalog, at most 2.

fromDatestring

First day, inclusive (YYYY-MM-DD, UTC).

toDatestring

Last day, inclusive (YYYY-MM-DD, UTC).

platformstring

Only with profileId. One of: tiktok, instagram, facebook, youtube, linkedin, twitter, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat, whatsapp, discord, slack.

granularitystring

day reads one post. One of: total, day.

originstring

Lists only. Defaults to all. One of: all, creatoros, external.

sortstring

A sort from the catalog, such as published-desc or likes-desc.

includestring

Comma-separated includes from the catalog.

changedSincestring

now (no rows, the starting cursor) or the previous pagination.nextCursor: one row per post whose metrics changed since, oldest first, across every account the key reads. Narrow with profileId and platform. Changes are kept 7 days; cursors older than 6 days are refused.

limitinteger

Rows per page, 50 by default, 100 at most.

cursorstring

pagination.nextCursor of the previous page, sent with the same query.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/posts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    "string"
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  },
  "meta": {
    "entity": "string",
    "granularity": "total",
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "missingIds": [
      "string"
    ],
    "total": "string",
    "metricsSample": {
      "posts": 0,
      "limit": 0
    },
    "stale": true,
    "staleSince": "string"
  }
}

Read follower and post totals per account, platform or scope over time

GET/v1/metrics/accounts

Works on: Every network

Reads followers, the account counters the platform reports (media count, video count...) and the totals of the posts each account published, per account, per platform or for the whole scope, for the whole window or by day, week or month. - Scope: exactly one of accountId (up to 25) or profileId (one, with an optional platform). - groupBy: account (the default, one row per account and period), platform or none. - granularity: total (the default), day, week (rows start on Monday) or month. A row's date is the start of its period, never before fromDate.

Query parameters

accountIdstring

Comma-separated account ids, up to 25.

metricsstring

Comma-separated metric names from the catalog. Defaults to every metric.

groupBystring

Comma-separated groupings from the catalog, at most 2.

fromDatestring

First day, inclusive (YYYY-MM-DD, UTC).

toDatestring

Last day, inclusive (YYYY-MM-DD, UTC).

platformstring

Only with profileId. One of: tiktok, instagram, facebook, youtube, linkedin, twitter, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat, whatsapp, discord, slack.

granularitystring

One of: total, day, week, month.

attributionstring

One of: publish, received.

limitinteger

Rows per page, 50 by default, 100 at most.

cursorstring

pagination.nextCursor of the previous page, sent with the same query.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/accounts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "date": "2026-10-10T00:00:00.000Z",
      "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
      "platform": "social",
      "username": "string",
      "metrics": {}
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  },
  "meta": {
    "entity": "string",
    "granularity": "total",
    "groupBy": "account",
    "attribution": "publish",
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "stale": true,
    "staleSince": "string"
  }
}

Read live account or post insights from the platform

GET/v1/metrics/insights

Works on: Every network

Reads insights the platform computes and Creator OS does not store (page views, profile visits, watch time, audience demographics...), live from the platform, for one account or one of its posts (platformPostId). Platforms: Facebook, Instagram, LinkedIn, TikTok, YouTube, Pinterest, Google Business and Google Search Console. Another platform answers 400 on accountId, a disconnected account 401 account_disconnected, and a platform error the platform's own code under platformError. - granularity: total (the default) or day.

Query parameters

accountIdstringrequired

One account id.

metricsstring

Comma-separated metric names (up to 25). Defaults to the platform's default metrics. GET /v1/metrics/catalog?entity=insights&platform=... lists them.

platformPostIdstring

One post of the account, by its platform id: answers the post's live insights instead of the account's.

granularitystring

Defaults to total; groupBy=hour answers per day. One of: total, day.

groupBystring

demographic: audience segments (age, gender, country...). hour: Instagram followers online per day and hour, last 30 days. keyword: Google Business search keywords per month. query, page, country, device: Google Search Console, combined with commas (groupBy=query,country).

breakdownstring

With groupBy=demographic: comma-separated segments. Defaults to the platform's default segments.

timeframestring

Instagram demographics only. Defaults to this_month. One of: this_week, this_month.

cursorstring

With groupBy=keyword or a Search Console account: pagination.nextCursor of the previous page, sent with the same query.

limitinteger

Search Console accounts only: rows per page. Defaults to 1,000.

includestring

With platformPostId on YouTube: retentionCurve adds the audience retention curve.

fromDatestring

First day, inclusive (YYYY-MM-DD, UTC). Defaults to 30 days before toDate. The window is at most 541 days.

toDatestring

Last day, inclusive (YYYY-MM-DD, UTC). Defaults to today.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/insights?accountId=acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "date": "2026-10-10T00:00:00.000Z",
      "breakdown": "string",
      "dimension": "string",
      "dimensionId": "string",
      "dimensions": {},
      "metrics": {}
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  },
  "meta": {
    "entity": "string",
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
    "platformPostId": "string",
    "platform": "social",
    "granularity": "total",
    "groupBy": "string",
    "timeframe": "this_week",
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "unavailableMetrics": [
      {
        "metric": "string",
        "reason": "string",
        "message": "string"
      }
    ],
    "units": {},
    "dataDelay": "string",
    "provisionalSince": "string",
    "stale": true
  },
  "retentionCurve": {
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "provisionalSince": "string",
    "durationSeconds": 0,
    "segmentMetricsAvailable": true,
    "points": [
      {
        "elapsedVideoTimeRatio": 0,
        "audienceWatchRatio": 0,
        "relativeRetentionPerformance": 0,
        "startedWatching": 0,
        "stoppedWatching": 0,
        "totalSegmentImpressions": 0
      }
    ]
  }
}

Read message volume and response times

GET/v1/metrics/inbox

Works on: Every network

Counts messages received, sent, read and failed, conversations and replies, and response times (median, p90, p99, mean, min, max) across the inbox, from the messages Creator OS logged. - Scope: conversationId (up to 25, one row per conversation), accountId (up to 25) or one profileId. Without a scope, every account the key can read. - groupBy (at most 2): account, platform, source, hourOfWeek (one row per UTC weekday and hour), responseTimeBucket (with metrics=replied) or conversation (paged with cursor, include=total counts up to 100,000). - granularity: total (the default), day or week.

Query parameters

conversationIdstring

Comma-separated conversation ids (Creator OS or platform), up to 25: one row per conversation.

accountIdstring

Comma-separated account ids, up to 25.

metricsstring

Comma-separated metric names from the catalog. Defaults to the counts; response times only when named.

groupBystring

Comma-separated groupings from the catalog, at most 2: account, conversation, platform, source, hourOfWeek, responseTimeBucket.

fromDatestring

First day, inclusive (YYYY-MM-DD, UTC). Defaults to 30 days before toDate. The window is at most 90 days.

toDatestring

Last day, inclusive (YYYY-MM-DD, UTC). Defaults to today.

platformstring

A messaging platform, such as instagram or whatsapp.

sourcestring

Only messages sent from this source, such as api or broadcast. Not with response time metrics.

granularitystring

One of: total, day, week.

sortstring

A sort from the catalog, such as messages-desc. With granularity=total.

includestring

Comma-separated includes from the catalog: account, conversation, total.

limitinteger

Rows returned with groupBy=account (10 by default, 100 at most) or groupBy=conversation (50 by default, 1,000 at most).

cursorstring

With groupBy=conversation: pagination.nextCursor of the previous page.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/inbox" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "date": "2026-10-10T00:00:00.000Z",
      "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
      "platform": "social",
      "source": "string",
      "dayOfWeek": 0,
      "hour": 0,
      "responseTimeBucket": {
        "label": "string",
        "lowerSeconds": 0,
        "upperSeconds": 0
      },
      "account": {
        "username": "string",
        "displayName": "string"
      },
      "conversationId": "conv_M4nB7vC1xZ9lK3jH6gF2dS8aP5oI0uY7tR4eW1qQ6",
      "firstMessageAt": "2026-10-10T00:00:00.000Z",
      "lastMessageAt": "2026-10-10T00:00:00.000Z",
      "conversation": {
        "platformConversationId": "string",
        "participantName": "string",
        "participantUsername": "string",
        "participantPicture": "string",
        "lastMessage": "string"
      },
      "metrics": {}
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  },
  "meta": {
    "entity": "string",
    "granularity": "total",
    "groupBy": [
      "string"
    ],
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "total": 0,
    "totalIsCapped": true,
    "stale": true,
    "staleSince": "string"
  }
}

Read ad metrics by id, or one ad day by day with breakdowns

GET/v1/metrics/ads

Works on: Every network

Reads the delivery and conversion metrics Creator OS synced from the ad networks for up to 100 Creator OS ad ids (adId, as GET /v1/ads returns them). Ids you cannot read come back in meta.missingIds. - granularity=day with one ad: one point per day. - breakdowns with one ad: read live from the network (age, gender, country, placement...), with attributionWindows for Meta. Without fromDate and toDate it reads the last 90 days; the window is at most 730 days. meta.backfillPending is true while older days are still being fetched. Money is in the ad account currency (currency).

Query parameters

adIdstringrequired

Comma-separated Creator OS ad ids, up to 100.

granularitystring

day reads one ad, one point per day. One of: total, day.

fromDatestring

Without fromDate and toDate, the last 90 days.

toDatestring

Last day, inclusive (YYYY-MM-DD, UTC).

breakdownsstring

Comma-separated breakdowns, read live from the platform. One ad only.

attributionWindowsstring

Meta attribution windows for the breakdowns, comma-separated.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/ads?adId=%3CadId%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "adId": "string",
      "name": "string",
      "platform": "social",
      "status": "string",
      "currency": "string",
      "summary": {
        "spend": 0,
        "impressions": 0,
        "reach": 0,
        "clicks": 0,
        "engagement": 0,
        "ctr": 0,
        "cpc": 0,
        "cpm": 0,
        "conversions": 0,
        "allConversions": 0,
        "costPerConversion": 0,
        "actions": {},
        "actionValues": {},
        "purchaseValue": 0,
        "roas": 0,
        "costPerAction": {},
        "outboundClicks": 0,
        "outboundClicksCtr": 0,
        "inlineLinkClicks": 0,
        "inlineLinkClickCtr": 0,
        "uniqueClicks": 0,
        "uniqueCtr": 0,
        "funnel": {},
        "engagementBreakdown": {},
        "videoPlayActions": 0,
        "video30SecWatchedActions": 0,
        "videoThruplayWatchedActions": 0,
        "videoP25WatchedActions": 0,
        "videoP50WatchedActions": 0,
        "videoP75WatchedActions": 0,
        "videoP95WatchedActions": 0,
        "videoP100WatchedActions": 0,
        "videoAvgTimeWatchedActions": 0,
        "video2SecWatchedActions": 0,
        "video6SecWatchedActions": 0,
        "video6SecFocusedViews": 0,
        "costPerThruplay": 0,
        "lastSyncedAt": "2026-10-10T00:00:00.000Z",
        "qualityRanking": "string",
        "engagementRateRanking": "string",
        "conversionRateRanking": "string",
        "videoTotalWatchTime": 0
      },
      "daily": [
        {}
      ],
      "breakdowns": {},
      "unsupportedBreakdowns": [
        "string"
      ],
      "breakdownHints": {},
      "breakdownsRange": "string",
      "breakdownErrors": [
        "string"
      ],
      "breakdownDroppedMetrics": {}
    }
  ],
  "meta": {
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "backfillPending": true,
    "missingIds": [
      "string"
    ],
    "stale": true,
    "staleSince": "string"
  }
}

Read the uploaded results of each campaign over a window

GET/v1/metrics/campaigns

Works on: Every network

Sums, per campaign, each result metric you uploaded (one key per metric, as GET /v1/ads/campaign-results/metrics lists them), with cac_percent, cost_per_sale, cost_per_qualified_lead, lead_to_sale and qualified_rate next to them, over fromDate to toDate (both required, at most 400 days). Filter with campaignId (platform campaign ids); pages with cursor.

Query parameters

limitinteger

Rows per page, 50 by default, 100 at most.

cursorstring

pagination.nextCursor of the previous page, sent with the same query.

fromDatestringrequired

First day, inclusive.

toDatestringrequired

Last day, inclusive. The range is at most 400 days.

campaignIdstring

Comma-separated platform campaign ids.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/campaigns?fromDate=%3CfromDate%3E&toDate=%3CtoDate%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "platform": "social",
      "adAccountId": "string",
      "campaignId": "string",
      "results": {}
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  },
  "meta": {
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "stale": true,
    "staleSince": "string"
  }
}

Read the uploaded results summed across ad accounts

GET/v1/metrics/ad-accounts

Works on: Every network

Sums each result metric you uploaded across ad accounts (every ad account the key can read, or the platform ids in adAccountId) over fromDate to toDate (both required, at most 400 days), with the same metrics as GET /v1/metrics/campaigns.

Query parameters

fromDatestringrequired

First day, inclusive.

toDatestringrequired

Last day, inclusive. The range is at most 400 days.

adAccountIdstring

Comma-separated platform ad account ids. Defaults to every ad account the key sees.

curl "https://creatoros-production-5658.up.railway.app/v1/metrics/ad-accounts?fromDate=%3CfromDate%3E&toDate=%3CtoDate%3E" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "results": {},
  "meta": {
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z",
    "stale": true,
    "staleSince": "string"
  }
}

Run a Meta Marketing API insights query on one ad account

POST/v1/metrics/platform-queries/meta-ads

Works on: Every network

Reads Meta's insights for one ad account (act_<n>). Read its campaigns, ad sets or ads with level and filtering on the same ad account. Runs a native query on the platform with the account's own token and answers the platform's rows unchanged, with its own field names, plus its headers, counts and quota in meta. Use it for what /v1/metrics/* does not store; the stored metrics stay cheaper and faster. - Up to 120 reads per hour per platform target (the Creator OS account plus the ad account or property); past it, 429 with details.scope platform_query_target.

Body

accountIdstringrequired

The Creator OS id of the connected Meta ads account.

adAccountIdstringrequired

The Meta ad account, act_<n>. Read its campaigns, ad sets or ads with level and filtering.

levelstring

The level of each row. Defaults to the ad account.

fieldsstring[]

Meta insights fields, such as spend or impressions, up to 100.

breakdownsstring[]

Meta breakdowns, up to 5.

actionBreakdownsstring[]

An empty array asks Meta for no action breakdown at all.

actionAttributionWindowsstring[]

Meta attribution windows, such as 7d_click or 1d_view.

actionReportTimestring

impression, conversion or mixed.

useUnifiedAttributionSettingboolean

Use each ad set's own attribution setting.

filteringobject[]

Meta filters of field, operator and value, up to 25.

datePresetstring

A Meta date preset, such as last_30d. Not with fromDate and toDate.

fromDatestring

First day, YYYY-MM-DD, sent with toDate.

toDatestring

Last day, YYYY-MM-DD, sent with fromDate.

timeIncrementstring

Days per row, 1 to 90, or monthly or all_days.

limitinteger

Rows per page, up to 500. Defaults to 500.

cursorstring

The pagination.nextCursor of the previous page, unchanged.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/metrics/platform-queries/meta-ads" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
    "adAccountId": "string"
  }'
Response 200
{
  "data": [
    "string"
  ],
  "meta": {
    "source": "string",
    "platform": "social"
  },
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

Run a Google Ads Query Language search on one customer

POST/v1/metrics/platform-queries/google-ads

Works on: Every network

Runs a GAQL SELECT on one Google Ads customer, read only. Without adAccountId it reads the connection's own customer. Runs a native query on the platform with the account's own token and answers the platform's rows unchanged, with its own field names, plus its headers, counts and quota in meta. Use it for what /v1/metrics/* does not store; the stored metrics stay cheaper and faster. - Up to 120 reads per hour per platform target (the Creator OS account plus the ad account or property); past it, 429 with details.scope platform_query_target. - Up to 10 queries in flight per team.

Body

accountIdstringrequired

The Creator OS id of the connected Google Ads account.

adAccountIdstring

The Google Ads customer to query. Defaults to the connection's own customer.

querystringrequired

A GAQL SELECT statement, up to 10,000 characters. Read only.

cursorstring

The pagination.nextCursor of the previous page, unchanged.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/metrics/platform-queries/google-ads" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
    "query": "string"
  }'
Response 200
{
  "data": [
    "string"
  ],
  "meta": {
    "source": "string",
    "platform": "social"
  },
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}

Run a TikTok Marketing API report on one advertiser

POST/v1/metrics/platform-queries/tiktok-ads

Works on: Every network

Runs a synchronous TikTok report (BASIC or AUDIENCE) for one advertiser at the data level asked. Runs a native query on the platform with the account's own token and answers the platform's rows unchanged, with its own field names, plus its headers, counts and quota in meta. Use it for what /v1/metrics/* does not store; the stored metrics stay cheaper and faster. - Up to 120 reads per hour per platform target (the Creator OS account plus the ad account or property); past it, 429 with details.scope platform_query_target. - Up to 10 queries in flight per team.

Body

accountIdstringrequired

The Creator OS id of the connected TikTok ads account.

adAccountIdstringrequired

The numeric TikTok advertiser id.

reportTypestring

Defaults to BASIC.

dataLevelstringrequired

The level of each row.

dimensionsstring[]required

TikTok dimensions, 1 to 4.

metricsstring[]required

TikTok metrics, up to 100.

filteringobject[]

TikTok filters of field, operator and value, up to 25. A filter on an entity finer than dataLevel is refused.

fromDatestringrequired

First day, YYYY-MM-DD, inclusive.

toDatestringrequired

Last day, YYYY-MM-DD, inclusive.

pageSizeinteger

Rows per page, up to 1,000. Defaults to 1,000.

cursorstring

The pagination.nextCursor of the previous page, unchanged.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/metrics/platform-queries/tiktok-ads" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
    "adAccountId": "string",
    "dataLevel": "AUCTION_ADVERTISER",
    "dimensions": [
      "string"
    ],
    "metrics": [
      "string"
    ],
    "fromDate": "2026-10-10T00:00:00.000Z",
    "toDate": "2026-10-10T00:00:00.000Z"
  }'
Response 200
{
  "data": [
    "string"
  ],
  "meta": {
    "source": "string",
    "platform": "social"
  },
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}