Skip to content
ansvra.Documentation
Reports
Reports

Read crawlers report

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

GET/projects/{projectId}/reports/crawlers
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.

viewstringOptional

overview, pages, bots or events.

Default: overview

eventCursorstringOptional

Signed data.nextCursor from the events view. Keep every other parameter unchanged.

sourcestringOptional

Filter saved crawler activity by source.

platformstringOptional

Filter saved crawler activity by platform.

botstringOptional

Filter saved crawler activity by bot.

intentstringOptional

Filter saved crawler activity by intent.

statusstringOptional

Filter saved crawler activity by status.

pathstringOptional

Filter saved crawler activity by path.

searchstringOptional

Search saved request paths, up to 500 characters.

pageintegerOptional

Page for pages/bots views, starting at 1.

Default: 1

sortstringOptional

requests, page or lastSeen.

Default: requests

directionstringOptional

asc or desc.

Default: desc

Response fields

dataobjectRequired

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

Child fields
totalsobjectOptional

Saved totals for this report or view.

Child fields
requestsnumberOptional

Saved requests for this report or view.

pagesnumberOptional

Saved pages for this report or view.

botsnumberOptional

Saved bots for this report or view.

failednumberOptional

Saved failed for this report or view.

knownnumberOptional

Saved known for this report or view.

unknownnumberOptional

Mentions without a usable sentiment classification.

previousvalue | nullOptional

Saved previous for this report or view.

trendarrayOptional

Saved trend for this report or view.

pagesarrayOptional

Saved pages for this report or view.

botsarrayOptional

Saved bots for this report or view.

coveragearrayOptional

Saved evidence coverage and its limitations.

truncatedbooleanOptional

Saved truncated for this report or view.

kindstringOptional

Saved kind for this report or view.

groupingstringOptional

Saved grouping for this report or view.

metaobjectRequired

Request metadata. Present on JSON success responses.

Child fields
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…