discovery

Get location reports

Deprecated: use discovery.location-reports.get.v2 (discovery_location_reports_get_v2), which answers the results window it reads in scope.window, each place's change since 30 days before the as-of day (null without one), and no precision fields; this version reads the same, names in scope.dispatchId the newest run that measured a conversation of the window's last 30 days, and reads a change it cannot name as 0. Read a campaign's Locations report: its customers rolled up country → region → city → postcode, with each place's brand share, win rate, win and loss reasons, and revenue influence, under an optional brand lens and segments. Pass drivers=false or revenue=false to skip those reads.

get/api/v1/discovery/location-reports/{id}

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/location-reports/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Path parameters

idstring uuid required

Discovery campaign id.

Query parameters

dateRangestring nullable

Result window: all, a preset id, or yyyy-MM-dd..yyyy-MM-dd. Omit for the campaign's default window.

brandPerspectivestring nullable

Read the results as this brand (one of the campaign's brands). Omit for your own.

segmentsstring[]

Narrows the read to these segments, ANDed: one axis:id per axis (any number of distinct customer: entries), in canonical axis order. Empty reads the whole dispatch.

driversboolean

Read each place's win and loss reasons. Default true; false leaves drivers empty.

revenueboolean

Read revenue influence. Default true; it is read only under the campaign's own brand.

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

Changes

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