Skip to main content
GET
Get Perception Claim

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer hrld_....

Path Parameters

brand_id
string<uuid>
required
claim
string
required
Required string length: 1 - 300

Query Parameters

engine
enum<string> | null
Available options:
perplexity,
gemini,
openai,
google_aio,
ai_mode,
copilot,
claude
prompt
string<uuid> | null
type
enum<string> | null
Available options:
organic,
brand_specific,
competitor_comparison
intent
enum<string> | null
Available options:
educational,
problem,
comparison,
transactional
topic
string<uuid> | null
segment
string | null
as_of
string<uuid> | null

Include only scans up to this completed scan id.

period
enum<string>
default:1w
Available options:
1w,
4w,
12w,
all
list_limit
integer | null
Required range: 1 <= x <= 100
prompts_offset
integer
default:0
Required range: x >= 0
sources_offset
integer
default:0
Required range: x >= 0
pages_offset
integer
default:0
Required range: x >= 0

Response

Successful Response

added_at
string<date-time> | null
required
claim
V1PerceptionClaimRow · object
required
engines
V1PerceptionClaimEngine · object[]
required
filters
FigureFilters · object
required
meta
Meta · object
required

Normalized query and newest included scan.

pages
V1PerceptionContradictingPage · object[]
required
pages_total
integer
required
period
V1Period · object
required
prompts
V1PerceptionClaimPrompt · object[]
required
prompts_total
integer
required
quotes
V1PerceptionQuotedLine · object[]
required