Skip to content
ansvra.Documentation
Results and evidence
Results and evidence

Read prompt results

Read the prompt’s result history, evidence and metrics.

GET/projects/{projectId}/prompts/{promptId}/results
Required permission data:read

The key must include this project and its owner must still have access.

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.

promptIdstringRequired

Identifier from the corresponding resource list.

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.

tabstringOptional

overview, responses, citations or fanout.

Default: overview

platformstring · repeatedOptional

Repeat for each saved platform identifier.

modelstring · repeatedOptional

Repeat model identifiers to filter fan-out results.

fanoutKeystringOptional

Select a fan-out group’s history.

occurrencePageintegerOptional

Fan-out history page, starting at 1.

Default: 1

pageintegerOptional

Page, starting at 1. Responses: 20 per page; citations/fan-out: 50.

Default: 1

observationIdstringOptional

Filter by observationId. observationId selects one answer.

runIdstringOptional

Filter by runId. observationId selects one answer.

methodstringOptional

Filter by method. observationId selects one answer.

marketstringOptional

Filter by market. observationId selects one answer.

languagestringOptional

Filter by language. observationId selects one answer.

promptTypestringOptional

all, branded or discovery.

adsstring · repeatedOptional

yes, no or unknown.

shoppingstring · repeatedOptional

yes, no or unknown.

brandstring · repeatedOptional

yes, no or unknown.

citedstring · repeatedOptional

yes, no or unknown.

competitorstring · repeatedOptional

Filter competitor identifiers.

tonestring · repeatedOptional

positive, negative, neutral or unknown.

sortstringOptional

date_desc, date_asc, sentiment_asc or sentiment_desc.

Default: date_desc

formatstringOptional

json or csv.

Default: json

Response fields

dataobjectRequired

Read the prompt’s result history, evidence and metrics.

Child fields
promptobjectOptional

Saved prompt for this report or view.

Child fields
idstringOptional

Saved id for this report or view.

textstringOptional

Saved text for this report or view.

marketstringOptional

Saved market for this report or view.

languagestringOptional

Saved language for this report or view.

scopeobjectOptional

Resolved reporting period, filters and history boundaries.

Child fields
fromstringOptional

Saved from for this report or view.

tostringOptional

Saved to for this report or view.

platformsarrayOptional

Saved platforms for this report or view.

reportingStartDatestringOptional

First day available in the account’s reporting history.

historyUnavailablebooleanOptional

Saved history unavailable for this report or view.

reportingStartDatestringOptional

First day available in the account’s reporting history.

usablenumberOptional

Number of usable saved answers in the resolved scope.

historicalPlatformsarrayOptional

Saved historical platforms for this report or view.

tabstringOptional

Saved tab for this report or view.

ownobjectOptional

Saved own for this report or view.

Child fields
breakdownobjectOptional

Saved breakdown for this report or view.

Child fields
namestringOptional

Saved name for this report or view.

mentionednumberOptional

Saved mentioned for this report or view.

classifiednumberOptional

Saved classified for this report or view.

tonesobjectOptional

Saved tones for this report or view.

Child fields
positivenumberOptional

Saved positive for this report or view.

negativenumberOptional

Saved negative for this report or view.

neutralnumberOptional

Saved neutral for this report or view.

mixednumberOptional

Saved mixed for this report or view.

unknownnumberOptional

Mentions without a usable sentiment classification.

legacynumberOptional

Saved legacy for this report or view.

scorevalue | nullOptional

Saved score for this report or view.

groupsarrayOptional

Saved groups for this report or view.

idstringOptional

Saved id for this report or view.

namestringOptional

Saved name for this report or view.

domainstringOptional

Saved domain for this report or view.

domainsarrayOptional

Saved domains for this report or view.

brandAliasesarrayOptional

Saved brand aliases for this report or view.

ownbooleanOptional

Saved own for this report or view.

includeSubdomainsbooleanOptional

Saved include subdomains for this report or view.

usablenumberOptional

Number of usable saved answers in the resolved scope.

mentionednumberOptional

Saved mentioned for this report or view.

citednumberOptional

Saved cited for this report or view.

visibilityvalue | nullOptional

Saved visibility for this report or view.

citationRatenumberOptional

Saved citation rate for this report or view.

citationCountnumberOptional

Saved citation count for this report or view.

mentionOrdervalue | nullOptional

Saved mention order for this report or view.

sentimentvalue | nullOptional

Saved sentiment for this report or view.

classifiednumberOptional

Saved classified for this report or view.

analysisCoveragevalue | nullOptional

Saved analysis coverage for this report or view.

tonesobjectOptional

Saved tones for this report or view.

Child fields
positivenumberOptional

Saved positive for this report or view.

negativenumberOptional

Saved negative for this report or view.

neutralnumberOptional

Saved neutral for this report or view.

mixednumberOptional

Saved mixed for this report or view.

brandsarrayOptional

Saved brands for this report or view.

Child fields
breakdownobjectOptional

Saved breakdown for this report or view.

Child fields
namestringOptional

Saved name for this report or view.

mentionednumberOptional

Saved mentioned for this report or view.

classifiednumberOptional

Saved classified for this report or view.

tonesobjectOptional

Saved tones for this report or view.

Child fields
positivenumberOptional

Saved positive for this report or view.

negativenumberOptional

Saved negative for this report or view.

neutralnumberOptional

Saved neutral for this report or view.

mixednumberOptional

Saved mixed for this report or view.

unknownnumberOptional

Mentions without a usable sentiment classification.

legacynumberOptional

Saved legacy for this report or view.

scorevalue | nullOptional

Saved score for this report or view.

groupsarrayOptional

Saved groups for this report or view.

idstringOptional

Saved id for this report or view.

namestringOptional

Saved name for this report or view.

domainstringOptional

Saved domain for this report or view.

domainsarrayOptional

Saved domains for this report or view.

brandAliasesarrayOptional

Saved brand aliases for this report or view.

ownbooleanOptional

Saved own for this report or view.

includeSubdomainsbooleanOptional

Saved include subdomains for this report or view.

usablenumberOptional

Number of usable saved answers in the resolved scope.

mentionednumberOptional

Saved mentioned for this report or view.

citednumberOptional

Saved cited for this report or view.

visibilitynumberOptional

Saved visibility for this report or view.

citationRatenumberOptional

Saved citation rate for this report or view.

citationCountnumberOptional

Saved citation count for this report or view.

mentionOrdervalue | nullOptional

Saved mention order for this report or view.

sentimentvalue | nullOptional

Saved sentiment for this report or view.

classifiednumberOptional

Saved classified for this report or view.

analysisCoveragevalue | nullOptional

Saved analysis coverage for this report or view.

tonesobjectOptional

Saved tones for this report or view.

Child fields
positivenumberOptional

Saved positive for this report or view.

negativenumberOptional

Saved negative for this report or view.

neutralnumberOptional

Saved neutral for this report or view.

mixednumberOptional

Saved mixed for this report or view.

trendarrayOptional

Saved trend for this report or view.

Child fields
datestringOptional

Saved date for this report or view.

rowsarrayOptional

Rows in this report’s current view.

Child fields
idstringOptional

Saved id for this report or view.

coveragevalue | nullOptional

Saved evidence coverage and its limitations.

totalCitationsnumberOptional

Saved total citations for this report or view.

competitorsarrayOptional

Saved competitors for this report or view.

metaobjectRequired

Request metadata. Present on JSON success responses.

Child fields
scopeobjectOptional

Resolved reporting period, filters and history boundaries.

Child fields
fromstringOptional

Saved from for this report or view.

tostringOptional

Saved to for this report or view.

platformsarrayOptional

Saved platforms for this report or view.

reportingStartDatestringOptional

First day available in the account’s reporting history.

historyUnavailablebooleanOptional

Saved history unavailable 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…