Get Crawler

AI crawler analytics - see which AI models are visiting your site, how often, and which pages they crawl most.

Requires authentication

60 req/min

Endpoint

GET/get-crawler

Returns AI crawler visit analytics for a brand. Requires the crawler feature entitlement (available on paid plans, not during trial).

Query Parameters

brand_idstringrequired

Brand ID from /get-brands

viewstring

View type: "dashboard" (default) or "recent"

daysinteger

Number of days for dashboard view (1-30)

Default: 7

Dashboard View

The default view=dashboard returns comprehensive analytics: summary metrics, crawler distribution, daily time series, top pages, and recent activity.

summary Object

total_visitsinteger

Total crawler visits in the period

total_visits_changenumber

Percentage change vs previous period (null if no prior data)

unique_pagesinteger

Number of unique pages crawled

unique_pages_changenumber

Percentage change in unique pages vs previous period

avg_daily_visitsnumber

Average daily crawler visits

top_crawlerstring

Most active AI crawler (e.g. "ChatGPT", "Perplexity")

distribution[] Items

crawlerstring

Crawler name (ChatGPT, Perplexity, Claude, Gemini, etc.)

countinteger

Total visits from this crawler

percentagenumber

Percentage of total visits

The time_series array contains one entry per day with a by_crawler breakdown. Days with no visits still appear with count: 0.

Recent View

Use view=recent to get the last 100 crawler visits. The days parameter is ignored in this view.

GET /get-crawler?brand_id=X&view=recent

Returns {"visits": [...], "total": 100} where each visit includes url, crawler, and visited_at timestamp.

Tracked Crawlers

Trakkr detects visits from these AI crawlers:

Crawler	AI Model
`ChatGPT`	OpenAI GPT-4o / GPT-5
`Claude`	Anthropic Claude
`Perplexity`	Perplexity AI
`Gemini`	Google Gemini
`DeepSeek`	DeepSeek
`Meta AI`	Meta Llama
`Apple`	Apple Intelligence
`xAI`	xAI Grok

Feature Gating

This endpoint requires the crawler entitlement. It is available on paid plans only and not during free trials. Requests without the entitlement will receive a 403 Forbidden response.

Code Example

Request

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

1{
2  "summary": {
3    "total_visits": 1842,
4    "total_visits_change": 23.5,
5    "unique_pages": 47,
6    "unique_pages_change": 12.0,
7    "avg_daily_visits": 263.1,
8    "top_crawler": "ChatGPT"
9  },
10  "distribution": [
11    { "crawler": "ChatGPT", "count": 892, "percentage": 48.4 },
12    { "crawler": "Perplexity", "count": 421, "percentage": 22.9 },
13    { "crawler": "Claude", "count": 312, "percentage": 16.9 },
14    { "crawler": "Gemini", "count": 217, "percentage": 11.8 }
15  ],
16  "time_series": [
17    { "date": "2026-03-01", "count": 245, "by_crawler": { "ChatGPT": 120, "Perplexity": 65 } },
18    { "date": "2026-03-02", "count": 278, "by_crawler": { "ChatGPT": 135, "Perplexity": 72 } }
19  ],
20  "top_pages": [
21    { "url": "https://example.com/pricing", "count": 312, "crawlers": ["ChatGPT", "Perplexity"] },
22    { "url": "https://example.com/features", "count": 198, "crawlers": ["ChatGPT", "Claude"] }
23  ],
24  "recent_activity": [
25    { "id": "0", "url": "https://example.com/pricing", "crawler": "ChatGPT", "visited_at": "2026-03-07T14:23:00Z" }
26  ],
27  "date_range": { "start": "2026-03-01", "end": "2026-03-07", "days": "7" }
28}

Request

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

1{
2  "summary": {
3    "total_visits": 1842,
4    "total_visits_change": 23.5,
5    "unique_pages": 47,
6    "unique_pages_change": 12.0,
7    "avg_daily_visits": 263.1,
8    "top_crawler": "ChatGPT"
9  },
10  "distribution": [
11    { "crawler": "ChatGPT", "count": 892, "percentage": 48.4 },
12    { "crawler": "Perplexity", "count": 421, "percentage": 22.9 },
13    { "crawler": "Claude", "count": 312, "percentage": 16.9 },
14    { "crawler": "Gemini", "count": 217, "percentage": 11.8 }
15  ],
16  "time_series": [
17    { "date": "2026-03-01", "count": 245, "by_crawler": { "ChatGPT": 120, "Perplexity": 65 } },
18    { "date": "2026-03-02", "count": 278, "by_crawler": { "ChatGPT": 135, "Perplexity": 72 } }
19  ],
20  "top_pages": [
21    { "url": "https://example.com/pricing", "count": 312, "crawlers": ["ChatGPT", "Perplexity"] },
22    { "url": "https://example.com/features", "count": 198, "crawlers": ["ChatGPT", "Claude"] }
23  ],
24  "recent_activity": [
25    { "id": "0", "url": "https://example.com/pricing", "crawler": "ChatGPT", "visited_at": "2026-03-07T14:23:00Z" }
26  ],
27  "date_range": { "start": "2026-03-01", "end": "2026-03-07", "days": "7" }
28}