Skip to main content
PATCH
Update a citation

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Body

application/json
status
enum<string>
required

Mark the page as handled, or put it back on the worklist. Archiving is a separate axis: use DELETE and /unarchive.

Available options:
new,
processed

Response

id
string
required
Example:

"3f1c2b4e-8d5a-4a2f-9c3e-7b1d6a5e4c20"

url
string
required
Example:

"https://rankspot.ai/blog/ai-seo-tools/"

domain
string
required
Example:

"rankspot.ai"

title
string | null
required

Title as the citing platform reported it.

Example:

"The 12 best AI SEO tools"

isOwnDomain
boolean
required

The page is on your own domain.

Example:

true

status
enum<string>
required
Available options:
new,
processed
firstSeenAt
string<date-time>
required

When this page was first and last cited, ever. Not clipped to the requested period.

lastSeenAt
string<date-time>
required
citations
number
required

Responses in the period that cited this page. One response can cite a page at most once, so this is both the citation count and the number of answers behind it.

Example:

14

platforms
enum<string>[]
required

Platforms that cited this page in the period.

Available options:
chatgpt,
perplexity,
google_ai_overview,
google_ai_mode