Skip to content
ansvra.Documentation
Reports
Reports

Read traffic report

Read traffic from saved information using the same reporting services as the app. No new collection is started.

GET/projects/{projectId}/reports/traffic
Required permission data:read

The 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 limits

Authorization

Authorizationstring · headerRequired

Bearer access key. Never put a key in the URL.

Path parameters

projectIdstringRequired

Project identifier from List projects.

Query parameters

fromYYYY-MM-DDOptional

Inclusive start date. Supply to with it; at most 366 days.

toYYYY-MM-DDOptional

Inclusive end date. Supply from with it.

assistantstringOptional

Comma-separated assistant names from the report.

countrystringOptional

Country filter.

devicestringOptional

desktop, mobile, tablet or smart tv.

landingstringOptional

Landing page filter, up to 1,000 characters.

eventstringOptional

Conversion event name filter.

Response fields

dataobjectRequired

Read traffic from saved information using the same reporting services as the app. No new collection is started.

Child fields
reportvalue | nullOptional

Saved report for this report or view.

searchvalue | nullOptional

Saved search for this report or view.

citationsarrayOptional

Saved citations for this report or view.

crawlersobjectOptional

Saved crawlers for this report or view.

Child fields
availablebooleanOptional

Saved available for this report or view.

pagesarrayOptional

Saved pages for this report or view.

fromstringOptional

Saved from for this report or view.

tostringOptional

Saved to for this report or view.

timezonestringOptional

Saved timezone for this report or view.

firstActivityDayvalue | nullOptional

Saved first activity day for this report or view.

lastActivityDayvalue | nullOptional

Saved last activity day for this report or view.

truncatedbooleanOptional

Saved truncated for this report or view.

coveragearrayOptional

Saved evidence coverage and its limitations.

Child fields
sourcestringOptional

Saved source for this report or view.

statusstringOptional

Saved status for this report or view.

metaobjectRequired

Request metadata. Present on JSON success responses.

Child fields
savedAtvalue | nullOptional

Saved saved at for this report or view.

rangeobjectOptional

Saved range for this report or view.

Child fields
fromstringOptional

Saved from for this report or view.

tostringOptional

Saved to for this report or view.

availabilitystringOptional

Saved availability for this report or view.

requestIdstringOptional

Saved request id for this report or view.

resultScopestringOptional

Saved result scope for this report or view.

Ansvra

A clearer next step.

MEET YOUR AI GUIDE

A little clarity.
A clearer next move.

Ask about Ansvra, AI visibility, or your next step with content.

Opening chat…