1. Reporting
GroundTruth - Public API
  • Welcome
  • Accounts
    • Get Accounts
    • Create Account
    • Get Account
    • Update Account
    • Delete Account
    • Get Account Min Cpv Bid Rate
    • Get Account Pixels
    • Create Account Pixel
    • Get Account Pixels Export
    • Delete Account Pixel
  • Campaigns
    • Get Campaigns
    • Create Campaign
    • Get Campaign
    • Update Campaign
    • Delete Campaign
    • Create Ad Package
  • Ad Groups
    • Create Adgroup
    • Get Adgroups
    • Update Adgroup
    • Patch Adgroup
    • Delete Adgroup
    • Get Adgroup
    • Get Adgroup Avails
    • Post Adgroup Avails
    • Create Dooh Adgroups
    • Download Location Filters
  • Health
    • Get Health
  • Organizations
    • Get Organizations
    • Create Organization
    • Get Organization
    • Update Organization
    • Delete Organization
  • Tenants
    • Get Tenant
    • Update Tenant
  • Direct Mail
    • Get Orders
  • Reporting
    • Get Ctv Ott Performance Campaign
      GET
    • Get Ctv Ott Performance Adgroup
      GET
    • Get Timeseries Dow Campaign
      GET
    • Get Product Insights Campaign
      GET
    • Get Product Insights Adgroup
      GET
    • Get Product Insights Creative
      GET
    • Get Product Insights Campaign Targeting
      GET
    • Get Product Insights Campaign Audience
      GET
    • Get Product Insights Campaign Adgroups
      GET
    • Get Product Insights Campaign Creatives
      GET
    • Get Visitation Lag Window Campaign
      GET
    • Get Top Locations Campaign
      GET
    • Get Top Sv Locations Campaign
      GET
    • Get Top Sv Locations Adgroup
      GET
    • Get Top Imp Locations Adgroup
      GET
    • Get Totals Account
      GET
    • Get Totals Organization
      GET
    • Post Totals Tenant
      POST
    • Get Totals Account V2
      GET
    • Get Totals Campaign
      GET
    • Get Totals Adgroup
      GET
    • Get Demographics Partial Adgroup
      GET
    • Get Totals Creative
      GET
    • Get Totals Campaign Creatives
      GET
    • Get Audio Podcast Topic Metrics Campaign
      GET
    • Get Audio Podcast Topic Metrics Adgroup
      GET
    • Get Audio Podcast Series Metrics Campaign
      GET
    • Get Audio Podcast Series Metrics Adgroup
      GET
    • Get Campaign Recommendations
      GET
    • Dismiss Recommendation
      PUT
    • Get Recommendation Count
      POST
    • Get Foot Traffic Attribution
      POST
    • Get Foot Traffic Attribution Detailed
      POST
    • Get Foot Traffic Attribution V2 Order Summary
      GET
    • Get Foot Traffic Attribution V2 Detailed
      GET
    • Get Mobile Category Campaign
      GET
    • Get Mobile Category Adgroup
      GET
    • Get Mobile Category All Adgroups
      GET
    • Get Demographics Partial Campaign
      GET
    • Get Age Gender Distribution Campaign
      GET
    • Get Age Gender Distribution Adgroup
      GET
    • Get Audience Affinity Creative
      GET
    • Get Audience Category Campaign
      GET
    • Get Audience Affinity Campaign
      GET
    • Get Audience Affinity Campaign Adgroups
      GET
    • Get Product Insights Campaign Adgroups
      GET
    • Get Audience Affinity Campaign Creatives
      GET
    • Get Audience Affinity Campaign V2
      GET
    • Get Audience Affinity Campaign Adgroups V2
      GET
    • Get Audience Affinity Creative V2
      GET
    • Get Audience Affinity Campaign Creatives V2
      GET
    • Get Audience Affinity Adgroup
      GET
    • Get Audience Affinity Adgroup V2
      GET
    • Get Audience Category Campaign All Adgroups
      GET
    • Get Audience Category Campaign Creatives
      GET
    • Get Audience Category Adgroup
      GET
    • Get Audience Category Creative
      GET
    • Get Audience Breakdown Campaign
      GET
    • Get Audience Breakdown Adgroup
      GET
    • Get Audience Breakdown Creative
      GET
    • Get Pixel Campaign
      GET
    • Get Pixel Adgroup
      GET
    • Get Campaign Spend
      GET
    • Get Adgroup Spend
      GET
    • Get Marketshare Campaign
      GET
    • Get Audio Podcast Ad Position Campaign
      GET
    • Get Audio Podcast Ad Position Campaign Adgroups
      GET
    • Get Audio Streaming Genre Campaign
      GET
    • Get Audio Streaming Genre Adgroup
      GET
    • Get Audio Streaming Genre Campaign Adgroups
      GET
    • Get Daily Metrics Campaign
      GET
    • Get Audio Publisher Campaign
      GET
    • Get Audio Publisher Adgroup
      GET
    • Get Audio Publisher Campaign All Adgroups
      GET
    • Get Daily Metrics Adgroup
      GET
    • Get Daily Metrics Creative
      GET
    • Get Ctv Publisher Adgroup
      GET
    • Get Ctv Publisher Campaign
      GET
    • Get Ctv Publisher Campaign Adgroups
      GET
    • Get Ctv Network Campaign
      GET
    • Get Ctv Network Campaign Adgroups
      GET
    • Get Ctv Network Adgroup
      GET
    • Get Daily Metrics Campaign Adgroups
      GET
    • Get Daily Metrics Campaign Creatives
      GET
    • Get Dooh Publisher Campaign
      GET
    • Get Dooh Venue Type Campaign
      GET
    • Get Web Engagement Campaign
      GET
  • Miscellaneous
    • Get Version
  • Search
    • Search Tenants
    • Search Organizations
    • Search Accounts
    • Search Campaigns
    • Search Adgroups
    • Search Creatives
    • Search Location Filters
    • Search Audiences
    • Search Neighborhoods
    • Search On Premise Locations
    • Search Drive To Locations
    • Search Location Groups
    • Search Ad Packages
  • Static
    • Get Account Verticals
    • Get Audio Podcast Topics
    • Get Audio Streaming Genres
    • Get Carriers
    • Get Cities
    • Get Ctv Content Categories
    • Get Streaming Video Content Categories
    • Get Streaming Video Premium Ctv Categories
    • Get Dmas
    • Get Publisher Categories
    • Get States
    • Get Iab Categories
  • Users
    • Signup
    • Activate
    • Get Current User
    • Get User
    • Delete User
    • Update User
    • Get Users
    • Invite User
  • Creatives
    • Create Creative
    • Get Creatives
    • Get Creative
    • Update Creative
    • Delete Creative
    • Patch Creative
    • Clone Creative
  • Audiences
    • Get Audience Taxonomy
    • Get Audience Recommendations
  • Jobs
    • Get Jobs
    • Create Campaign Bulk Upload Job
    • Confirm Campaign Bulk Upload Job
    • Create Location Filter Bulk Upload Job
    • Create Campaign Bulk Download Job
    • Confirm Location Filter Bulk Upload Job
    • Cancel Location Filter Bulk Upload Job
    • Get Job
  • Upload
    • Upload
  • Schemas
    • Schemas
      • AccountSearchResults
      • AdSpec
      • ActivateUserModel
      • CTVContentCategoriesModel
      • CTVContentCategoryModel
      • CampaignSearchRequest
      • Body_create_campaign_bulk_upload_jobs_campaign_bulk_upload_post
      • CampaignSearchResults
      • CreateAudienceModel
      • SearchRequest
      • SuccessResponse
      • InviteUserModel
      • BidType
    • AccountMinCPVBidRateModel
    • AccountModel
    • AccountPixelModel
    • AccountPixelsModel
    • AccountSearchResult
    • AccountType
    • AccountVertical
    • AccountVerticalModel
    • AccountVerticalsModel
    • AccountsModel
    • AdPackageModel
    • AdgroupModel
    • AdgroupAvailsResponse
    • AdPackageSearchResult
    • AgeRange
    • AdgroupSearchResult
    • ApplicationCode
    • Audience
    • AdgroupsModel
    • AdgroupSpendModel
    • AudienceModel
    • AdgroupsTodaySpendModel
    • AudienceTaxonomy
    • AdgroupStep
    • AudienceType
    • AppCode
    • AudioPodcastTopicModel
    • AudioPodcastFieldName
    • AudioPodcastTopicsModel
    • AudioPodcastSeriesMetricsAdgroupModel
    • AudienceCategoryAdgroupFieldName
    • AudienceAffinityAdgroupModel
    • AgeGenderDistributionCampaignModel
    • AudioStreamingGenreModel
    • AudioPodcastSeriesMetricsCampaignModel
    • AudienceCategoryAdgroupModel
    • AudienceCategoryCampaignAllAdgroupsModel
    • AudienceAffinityCampaignCreativeFieldName
    • AudioStreamingGenresModel
    • AudioPodcastTopicMetricsAdgroupModel
    • AudienceCategoryCampaignModel
    • AudienceAffinityCampaignModel
    • BestAudiencesModel
    • AudioPodcastTopicMetricsCampaignModel
    • AudienceCategoryCreativeFieldName
    • AudienceAffinityCampaignSummaryModel
    • BestAudiencesSummaryModel
    • AudienceCategoryCreativeModel
    • AudienceAffinityCreativeModel
    • BestStrategiesModel
    • AudienceCategoryFieldName
    • AudienceAffinityFieldName
    • BestStrategiesSummaryModel
    • AudienceBreakdownAdgroupResponseModel
    • BillingSource
    • AudienceRecommendationsModel
    • AudienceBreakdownCampaignResponseModel
    • BudgetLevel
    • BlueprintsPolygonTypes
    • AudienceRecommendationsRequestModel
    • BudgetModel
    • AudienceSearchResult
    • BudgetModel
    • BudgetType
    • BasicAdgroupModel
    • AudienceCategoryCampaignCreativesModel
    • BusinessType
    • AudioPodcastAdPosition
    • AudienceBreakdownCreativeResponseModel
    • AudioPodcastAdPositionCampaignAdgroupsModel
    • AudioPodcastAdPositionCampaignModel
    • CampaignModel
    • CampaignSearchResult
    • Body_upload_upload_post
    • CampaignsModel
    • CitiesModel
    • CityModel
    • Community
    • AudioPublisherAdgroupModel
    • CountryCode
    • AudioPublisherCampaignAllAdgroupsModel
    • CreateAccountModel
    • CTVAppModel
    • AudioPublisherCampaignModel
    • CreateAccountPixelModel
    • CTVPremiumCategoriesModel
    • AudioStreamingGenreAdgroupModel
    • CreateAdgroupModel
    • AudioStreamingGenreCampaignAllAdgroupsModel
    • AudioStreamingGenreCampaignModel
    • CreateCampaignModel
    • CreateCreativeModel
    • CreateOrUpdateOrganizationModel
    • CreativeModel
    • CreativeType
    • CtvOttCampaignPerformanceModel
    • CtvOttCampaignSortByFieldName
    • CtvOttDeviceSummaryModel
    • CtvOttNetworkSummaryModel
    • CreateDoohAdgroupModel
    • CtvOttPublisherSummaryModel
    • CreateDoohAdgroupsModel
    • Body_create_campaign_bulk_upload_job_jobs_campaign_bulk_upload_post
    • CtvOttReportSummaryModel
    • Currency
    • CampaignSpendModel
    • DMAModel
    • DMAsModel
    • DartBillingAccount
    • CreateUpdateAudienceModel
    • CreateUpdateCTVPremiumCategoryModel
    • DetailedAudienceCategory
    • CreateUpdateDriveToLocationModel
    • ErrorModel
    • CreativeStatus
    • CreateUpdateStreamingVideoContentCategoryModel
    • CreateUpdatePublisherCategoryModel
    • ErrorResponseModel
    • Gender
    • CreativesModel
    • CreativeSearchResult
    • CreativeAPI
    • Group
    • HTTPValidationError
    • BillabilityType
    • IncomeRange
    • LocationFilterModel
    • DOOHAdgroupsModel
    • LocationFilterType
    • DOOHCreativeFormat
    • LookalikeAudienceScale
    • DOOHGeoCityModel
    • MediaType
    • DOOHGeoCountyModel
    • MobileCarrierModel
    • DOOHGeoDmaModel
    • MobileCarriersModel
    • DOOHGeoLocationGroupModel
    • CreateUpdateAudioPodcastTopicModel
    • OptimizationStrategy
    • DOOHGeoStateModel
    • CreateUpdateAudioStreamingGenreModel
    • OrderModel
    • DOOHGeoZipcodeModel
    • CreateCampaignBulkDownloadJobRequestModel
    • OrdersModel
    • DOOHLocationGroupDistanceUnits
    • OrganizationModel
    • DOOHPlanDataModel
    • OrganizationsModel
    • DOOHVenueTypeModel
    • PaymentType
    • ProductInsightsCampaignFieldName
    • POIPolygonModel
    • CreativeBlockedStatus
    • CreateLocationFilterTargetBulkUploadJobModel
    • ProductInsightsCampaignModel
    • CreateNeighborhoodModel
    • PublisherCategoriesModel
    • PublisherCategoryModel
    • FootTrafficAttributionFieldName
    • FootTrafficAttributionDefaultFields
    • DOOHPublisherModel
    • Sensitivity
    • FootTrafficAttributionFilterModel
    • SignupModel
    • FootTrafficAttributionGroupByFieldName
    • SignupResponseModel
    • FootTrafficAttributionModel
    • CreateAdPackageModel
    • SortOrder
    • FootTrafficAttributionRequestModel
    • StateModel
    • DriveToLocationModel
    • StatesModel
    • DriveToLocationType
    • Status
    • TargetingTactic
    • IABCategoriesResponseModel
    • TenantModel
    • IABCategoryModel
    • TenantType
    • TimeseriesDowCampaignModel
    • CreateUpdateOnPremiseLocationModel
    • Timezone
    • CreateUpdateAdPackageModel
    • TopSVLocationsCampaignModel
    • TotalsCampaignCreativesModel
    • FootTrafficAttributionDetailedFilterModel
    • CreateUpdateTrackingPixelModel
    • TotalsCampaignModel
    • TopSVLocationsCampaignFieldName
    • FootTrafficAttributionDetailedModel
    • UpdateAccountModel
    • FootTrafficAttributionV2DetailedModel
    • FootTrafficAttributionDetailedRequestModel
    • UpdateCampaignModel
    • FootTrafficAttributionV2OrderSummaryModel
    • UpdateTenantModel
    • UpdateUserModel
    • UserModel
    • UserStatus
    • UsersModel
    • CtvOttAdgroupPerformanceModel
    • CreatedAdPackageModel
    • ValidationError
    • VersionModel
    • JobModel
    • VisitationLagWindowModel
    • RecommendationModel
    • AudienceType
    • RecommendationStatus
    • RecommendationsModel
    • BidType
    • AudienceType
    • CtvPublisherAdgroupModel
    • CtvPublisherCampaignAdgroupsModel
    • CtvNetworkRowModel
    • MobileCategoryAdgroupModel
    • CtvPublisherNetworkModel
    • CtvNetworkSortByFieldName
    • MobileCategoryCampaignAllAdgroupsModel
    • MobileCategoryCampaignModel
    • DailyMetricsAdgroupModel
    • MobileCategoryFieldName
    • DailyMetricsCampaignModel
    • DailyMetricsCreativeModel
    • OrganizationSearchResult
    • DriveToLocationsSearchResult
    • PatchAdgroupModel
    • LocationFilterSearchResult
    • Language
    • RecommendationCountModel
    • JobStatus
    • DailyMetricsCampaignAdgroupsModel
    • RecommendationCountRequestModel
    • JobsModel
    • DailyMetricsCampaignAdgroupsResponseModel
    • DailyMetricsCampaignCreativesModel
    • SearchAccountsRequestModel
    • SearchAccountsResultsModel
    • SearchAdgroupsRequestModel
    • GetDailyMetricsAdgroupResponseModel
    • SearchAdgroupsResultsModel
    • GetDailyMetricsCampaignResponseModel
    • UpdateAdgroupModel
    • SearchCampaignsRequestModel
    • GetDailyMetricsCreativeResponseModel
    • SearchCampaignsResultsModel
    • UpdateCreativeModel
    • SearchCreativesRequestModel
    • SearchCreativesResultsModel
    • SearchOrganizationsResultsModel
    • SearchRequestModel
    • Objective
    • SearchTenantsResultsModel
    • DemographicsPartialAgeModel
    • DemographicsPartialGenderModel
    • PatchCreativeModel
    • DoohPublisherCampaignModel
    • DoohPublisherCampaignSortByFieldName
    • DoohVenueTypeCampaignModel
    • LocationFiltersModel
    • DoohVenueTypeCampaignSortByFieldName
    • StreamingVideoContentCategoriesModel
    • LocationGroupMetadata
    • BidType
    • StreamingVideoContentCategoryModel
    • LocationGroupType
    • SearchAudiencesRequestModel
    • TenantSearchResult
    • SearchAudiencesResultsModel
    • SearchLocationFiltersRequestModel
    • NeighborhoodModel
    • SearchLocationFiltersResultsModel
    • NeighborhoodSearchResult
    • NeighborhoodTargetType
    • NeighborhoodType
    • LocationFilterModel
    • LocationFilterModel
    • OnPremiseLocationSearchResult
    • OnPremiseLocationType
    • GTLandingPagePageOverlayAction
    • OperatingSystem
    • UploadResponseModel
    • LocationGroupResult
    • UploadType
    • MarketShareCampaignModel
    • ImageLandingPage
    • CTVPremiumCategoryModel
    • PixelCampaignFieldName
    • PixelConversionModel
    • CTVPremiumCategoryModel
    • OnPremiseLocationModel
    • SearchDriveToLocationsRequestModel
    • ProductInsightsCampaignAdgroupsModel
    • UploadJobType
    • SearchNeighborhoodsRequestModel
    • ProductInsightsCampaignCreativesModel
    • SearchOnPremiseLocationsRequestModel
    • ProximityMode
    • SuccessResponseModel
    • SearchLocationGroupsRequestModel
    • SearchLocationGroupsResultsModel
    • SearchAdPackagesResultsModel
    • TrackingPixelModel
    • StandardSuperLandingPage
    • TopImpLocationsAdgroupFieldName
    • TopImpLocationsAdgroupMetricName
    • AudioPodcastTopicModel
    • TopImpLocationsAdgroupModel
    • AudioStreamingGenreModel
    • TopLocationsCampaignFieldName
    • TopLocationsCampaignModel
    • PublisherCategoryModel
    • TopLocationsMetricName
    • StreamingVideoContentCategoryModel
    • TopSVLocationsAdgroupModel
    • AudioPodcastTopicModel
    • AudioStreamingGenreModel
    • PublisherCategoryModel
    • TotalsTenantRequestModel
    • StreamingVideoContentCategoryModel
    • WebEngagementCampaignResponseModel
    • LocationGroupMetadata
    • LocationGroupMetadata
  1. Reporting

Get Top Imp Locations Adgroup

GET
https://api-public.groundtruth.com/reporting/top_imp_locations/adgroup/{adgroup_id}
Gets top or bottom locations by impressions, clicks, or secondary actions for an ad group.

Request

Path Params

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-public.groundtruth.com/reporting/top_imp_locations/adgroup/?location_type&metric&key&limit&sw_lat&sw_lng&ne_lat&ne_lng&tenant_id'

Responses

🟢200OK
application/json
Successful Response
Body

Example
[
    {
        "campaign_id": 0,
        "campaign_name": "string",
        "adgroup_id": 0,
        "adgroup_name": "string",
        "address": "string",
        "city": "string",
        "state": "string",
        "country": "string",
        "zip": "string",
        "latitude": 0,
        "longitude": 0,
        "dma": 0,
        "impressions": 0,
        "clicks": 0,
        "total_sa": 0,
        "xad_gross_revenue": 0,
        "ctr": 0
    }
]
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
Modified at 2026-03-26 20:02:47
Previous
Get Top Sv Locations Adgroup
Next
Get Totals Account