Read traffic report
Read traffic from saved information using the same reporting services as the app. No new collection is started.
/projects/{projectId}/reports/trafficdata:readThe key must include this project and its owner must still have access.
Report response structures vary by report type and available saved evidence. Dates default to the report’s recent reporting window.
Response examples use fictional saved information. Repeated array entries are shortened for readability; full responses contain all entries for the requested view or page. Null measurements mean unavailable, not zero.
Authentication and permissions · Errors and limitsAuthorization
Authorizationstring · headerRequiredBearer access key. Never put a key in the URL.
Path parameters
projectIdstringRequiredProject identifier from List projects.
Query parameters
fromYYYY-MM-DDOptionalInclusive start date. Supply to with it; at most 366 days.
toYYYY-MM-DDOptionalInclusive end date. Supply from with it.
assistantstringOptionalComma-separated assistant names from the report.
countrystringOptionalCountry filter.
devicestringOptionaldesktop, mobile, tablet or smart tv.
landingstringOptionalLanding page filter, up to 1,000 characters.
eventstringOptionalConversion event name filter.
Response fields
dataobjectRequiredRead traffic from saved information using the same reporting services as the app. No new collection is started.
Child fields
reportvalue | nullOptionalSaved report for this report or view.
searchvalue | nullOptionalSaved search for this report or view.
citationsarrayOptionalSaved citations for this report or view.
crawlersobjectOptionalSaved crawlers for this report or view.
Child fields
availablebooleanOptionalSaved available for this report or view.
pagesarrayOptionalSaved pages for this report or view.
fromstringOptionalSaved from for this report or view.
tostringOptionalSaved to for this report or view.
timezonestringOptionalSaved timezone for this report or view.
firstActivityDayvalue | nullOptionalSaved first activity day for this report or view.
lastActivityDayvalue | nullOptionalSaved last activity day for this report or view.
truncatedbooleanOptionalSaved truncated for this report or view.
coveragearrayOptionalSaved evidence coverage and its limitations.
Child fields
sourcestringOptionalSaved source for this report or view.
statusstringOptionalSaved status for this report or view.
metaobjectRequiredRequest metadata. Present on JSON success responses.
Child fields
savedAtvalue | nullOptionalSaved saved at for this report or view.
rangeobjectOptionalSaved range for this report or view.
Child fields
fromstringOptionalSaved from for this report or view.
tostringOptionalSaved to for this report or view.
availabilitystringOptionalSaved availability for this report or view.
requestIdstringOptionalSaved request id for this report or view.
resultScopestringOptionalSaved result scope for this report or view.