Analytics · TikTok

TikTok impressions by region, per advertiser

get/api/v1/analytics/tiktok/reach/regions

Request

  • Base URL: https://api.adsmom.com
  • URL: https://api.adsmom.com/api/v1/analytics/tiktok/reach/regions
  • Auth: HTTP bearer

Query parameters

advertiser_idsstring
Example:meta.advertiser.abc,meta.advertiser.def

Comma-separated advertiser id tokens. Defaults to all tracked.

date_fromstring

Start date (ISO 8601).

date_tostring

End date (ISO 8601).

region_codesstring

Comma-separated region codes (e.g. US,GB).

granularity'day' | 'week' | 'month'
Example:day

Response

Example response

{
  "series": [
    {
      "advertiser": {
        "gid": "gid://adsmom/tiktok/advertiser/123456",
        "id_token": "tiktok.advertiser.123456",
        "platform": "tiktok",
        "name": "Kaufland"
      },
      "regions": [
        {
          "region_code": "US",
          "impressions": 920000
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.