Meta top ads by reach

get/api/v1/analytics/meta/top-ads

Request

Base URL: https://api.adsmom.com
URL: https://api.adsmom.com/api/v1/analytics/meta/top-ads
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

{
  "ads": [
    {
      "gid": "gid://adsmom/facebook/ad/0f9c…",
      "id_token": "meta.ad.0f9c…",
      "advertiser": {
        "gid": "gid://adsmom/tiktok/advertiser/123456",
        "id_token": "tiktok.advertiser.123456",
        "platform": "tiktok",
        "name": "Kaufland"
      },
      "started_at": "2026-04-01",
      "ended_at": "2026-05-20",
      "total_reach": 318400
    }
  ]
}

Changes

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