Skip to main content
GET
/
v1
/
products
/
{productId}
/
prompts
/
dates
AI visibility timeseries
curl --request GET \
  --url https://api.siteline.ai/v1/products/{productId}/prompts/dates \
  --header 'Authorization: Bearer <token>'
[
  {
    "date": "2026-05-01T00:00:00Z",
    "platform": "openai",
    "domain": "example.com",
    "visibility": 0.42,
    "position": 2.5,
    "rank": 3
  }
]

Authorizations

​
Authorization
string
header
required

Siteline public API key. Create one under Team settings > Public API Key.

Path Parameters

​
productId
integer
required

Product ID returned by GET /v1/products.

Example:

42

Query Parameters

​
domain
string
required

Product domain to report metrics for, such as example.com.

Example:

"example.com"

​
dateFrom
string<date-time>
required

Inclusive start timestamp in RFC3339 format.

Example:

"2026-05-01T00:00:00Z"

​
dateTo
string<date-time>
required

Inclusive end timestamp in RFC3339 format.

Example:

"2026-05-31T23:59:59Z"

​
platforms[]
string[]

Platform filters. Common values: openai, gemini, google, perplexity, google_ai_overviews, claude.

​
labelIds[]
integer[]

Prompt label IDs to filter on. Invalid IDs return 400.

Response

Array of daily prompt trend rows.

​
date
string<date-time>
required
Example:

"2026-05-01T00:00:00Z"

​
platform
string
required
Example:

"openai"

​
domain
string
required
Example:

"example.com"

​
visibility
number | null
required

Percentage of AI responses in which the product appears on this day, expressed as a decimal. null when no data is available.

Example:

0.42

​
position
number | null
required

Average position of the product within AI response text on this day. null when no data is available.

Example:

2.5

​
rank
integer | null
required

Product's ranking by visibility compared to all competing products on this day. null when no data is available.

Example:

3