Get Top Locations Campaign

GET

https://api-public.groundtruth.com/reporting/top_locations/campaign/{campaign_id}

Gets top locations (impressions-based) for a campaign by state, DMA, or zipcode.

Request

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api-public.groundtruth.com/reporting/top_locations/campaign/?start_date&end_date&location_type&metric&key&sw_lat&sw_lng&ne_lat&ne_lng&limit&tenant_id'

Responses

🟢200OK

application/json

Successful Response

Body

Example

[
    {
        "campaign_id": 0,
        "campaign_name": "string",
        "state": "string",
        "country": "string",
        "dma": 0,
        "zip": "string",
        "city": "string",
        "impressions": 0,
        "clicks": 0,
        "ctr": 0,
        "secondary_actions": 0,
        "spend": 0,
        "visits": 0,
        "vcr": 0,
        "ltr": 0,
        "latitude": 0,
        "longitude": 0
    }
]

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Modified at 2026-03-26 20:02:47

Get Visitation Lag Window Campaign

Get Top Sv Locations Campaign