Skip to main content
GET
/
v1
/
products
/
{productId}
/
analytics
/
timeseries
Agent Analytics timeseries
curl --request GET \
  --url https://api.siteline.ai/v1/products/{productId}/analytics/timeseries \
  --header 'Authorization: Bearer <token>'
{
  "previousPage": null,
  "currentPage": 1,
  "nextPage": null,
  "totalPages": 1,
  "totalItems": 1,
  "perPage": 50,
  "items": [
    {
      "platform": "openai",
      "timestamp": "2026-05-04T00:00:00Z",
      "botVisits": 128,
      "aiReferredHumanVisits": 16
    }
  ]
}

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

​
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"

​
websiteId
string

Filter analytics to one website ID returned by GET /v1/products/{productId}/websites. If omitted, all active websites for the product are included.

Example:

"site_123"

​
interval
enum<string>
default:day

Time bucket size. Defaults to day.

Available options:
day,
week
​
metrics[]
enum<string>[]

Metrics to include in each row. Defaults to bot_visits.

Available options:
bot_visits,
human_visits,
referred_human_visits,
ai_referred_human_visits,
unique_human_visitors,
unique_pages,
unique_human_pages,
unique_human_platforms,
bot_user_agents
​
groupBy[]
enum<string>[]

Dimensions to group rows by.

Available options:
platform,
botType,
urlPath,
normalizedUrlPath,
urlPathDirectory
​
platforms[]
string[]

Filter by agent platform, such as openai.

​
botTypes[]
string[]

Filter by bot type, such as chatgpt-user.

​
urlPath
string

Filter by normalized URL path.

​
page
integer
default:1

Page number. Defaults to 1.

Required range: x >= 1
​
perPage
integer
default:20

Rows per page. Defaults to 20.

Required range: x >= 1
​
topLimit
integer

Return top-N rows per time bucket, ordered by the first requested metric.

Required range: x >= 1

Response

Paginated timeseries rows.

​
previousPage
integer | null
required
Example:

null

​
currentPage
integer
required
Example:

1

​
nextPage
integer | null
required
Example:

null

​
totalPages
integer
required
Example:

1

​
totalItems
integer
required
Example:

1

​
perPage
integer
required
Example:

50

​
items
object[]
required