AI Pages

Get AI Pages status, configuration, and usage stats for your brand's AI crawler optimization.

Requires authentication

60 req/min

Overview

The AI Pages endpoint (/ai-pages) returns the status, configuration, and usage stats for your brand's AI crawler optimization. AI Pages intercepts requests from AI crawlers (GPTBot, ClaudeBot, PerplexityBot) and serves optimized, AI-friendly versions of your pages.

What you get

- Whether AI Pages is enabled and which domain is configured
- Integration platform (Cloudflare, Vercel, Netlify, etc.)
- Active optimization features and enabled crawlers
- Monthly request usage vs. plan limits

If AI Pages has not been set up for this brand, both config and usage will be null. Set up AI Pages in Settings to start optimizing.

Get Status

GET/ai-pagesReturns AI Pages configuration and usage for a brand.

Query Parameters

brand_idstringrequired

The brand UUID to get AI Pages data for

Response

Top-level Response

brandobject

Brand metadata (id, name, website)

configobjectnullable

AI Pages configuration (null if not set up)

usageobjectnullable

Monthly usage stats (null if not set up)

Config Object

enabledboolean

Whether AI Pages is currently active

domainstring

The domain being optimized

platformstringnullable

Integration platform: cloudflare, vercel, netlify, nextjs, cloudfront, wordpress, node, nginx, or other

featuresarray

Active optimization features (e.g. structureddatainjection, keyfactsextraction)

crawlersarray

Enabled AI crawler IDs (e.g. gptbot, claudebot, perplexitybot)

Usage Object

requests_this_monthinteger

Number of AI crawler requests served this billing period

requests_limitinteger

Monthly request limit based on your plan

percentage_usednumber

Usage as a percentage (0-100)

reset_datestring

ISO 8601 timestamp when the usage counter resets

Understanding the Data

The response gives you a complete picture of your AI Pages setup:

Domain and Platform

The domain being optimized and how AI Pages is integrated (Cloudflare Workers, Vercel Edge Middleware, Netlify Edge Functions, etc.).

Features

Active optimization features: structured data injection, key facts extraction, automated FAQ generation, AI summary blocks, and entity recognition.

Crawlers

Which AI crawlers are being served optimized pages - GPTBot (ChatGPT), ClaudeBot (Claude), PerplexityBot, Google-Extended, and others.

Usage

How many AI crawler requests have been served this month relative to your plan limit, with the date when the counter resets.

Not Enabled Response

When AI Pages hasn't been set up for the brand, config and usage are null:

200 OK

1{
2  "brand": {
3    "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4    "name": "Notion",
5    "website": "https://notion.so"
6  },
7  "config": null,
8  "usage": null
9}

Requirements

This endpoint requires a paid plan with the AI Pages entitlement. Returns a 403 if your plan does not include this feature.

Brand access is verified - you must be a member of the brand you are querying.

The legacy path /prism still works as an alias for /ai-pages, but new integrations should use /ai-pages.

Looking for brand perception data (positioning, strengths, weaknesses)? Use GET /get-perception?view=narrative instead.

Code Example

Get AI Pages Status

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/ai-pages?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224'

200 OK

1{
2  "brand": {
3    "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4    "name": "Notion",
5    "website": "https://notion.so"
6  },
7  "config": {
8    "enabled": true,
9    "domain": "notion.so",
10    "platform": "cloudflare",
11    "features": [
12      "structureddatainjection",
13      "keyfactsextraction",
14      "automatedfaqgeneration",
15      "aisummaryblock"
16    ],
17    "crawlers": [
18      "gptbot",
19      "claudebot",
20      "perplexitybot",
21      "googleother"
22    ]
23  },
24  "usage": {
25    "requests_this_month": 4280,
26    "requests_limit": 10000,
27    "percentage_used": 42.8,
28    "reset_date": "2026-04-01T00:00:00+00:00"
29  }
30}

Get AI Pages Status

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/ai-pages?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224'

200 OK

1{
2  "brand": {
3    "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4    "name": "Notion",
5    "website": "https://notion.so"
6  },
7  "config": {
8    "enabled": true,
9    "domain": "notion.so",
10    "platform": "cloudflare",
11    "features": [
12      "structureddatainjection",
13      "keyfactsextraction",
14      "automatedfaqgeneration",
15      "aisummaryblock"
16    ],
17    "crawlers": [
18      "gptbot",
19      "claudebot",
20      "perplexitybot",
21      "googleother"
22    ]
23  },
24  "usage": {
25    "requests_this_month": 4280,
26    "requests_limit": 10000,
27    "percentage_used": 42.8,
28    "reset_date": "2026-04-01T00:00:00+00:00"
29  }
30}