Skip to main content
GET
Top Crawler Pages

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.

Query Parameters

startDate
string<date>

Start date for analytics data (YYYY-MM-DD). Max range 90 days.

endDate
string<date>

End date for analytics data (YYYY-MM-DD). Max range 90 days.

crawlers

Filter by crawler(s). Repeat for multiple: crawlers=openai-gptbot&crawlers=perplexity-bot. Allowed: openai-gptbot, openai-searchbot, openai-chatgpt-user, openai-adsbot, anthropic-claudebot, anthropic-claude-user, anthropic-claude-search-bot, anthropic-claude-web, anthropic-ai, perplexity-bot, perplexity-user, cohere-ai, mistral-ai-user, mistral-ai-index, deepseek-bot, x-ai-grok-bot, x-ai-grok-search, x-ai-grok-deep-search, google-extended, google-mobile-agent, google-desktop-agent, meta-web-indexer, meta-external-agent, meta-external-fetcher, meta-facebook-bot. If omitted, crawler activity trend uses every known key above; other operations that support this field may apply no per-crawler filter in the data store.

Available options:
openai-gptbot,
openai-searchbot,
openai-chatgpt-user,
openai-adsbot,
anthropic-claudebot,
anthropic-claude-user,
anthropic-claude-search-bot,
anthropic-claude-web,
anthropic-ai,
perplexity-bot,
perplexity-user,
cohere-ai,
mistral-ai-user,
mistral-ai-index,
deepseek-bot,
x-ai-grok-bot,
x-ai-grok-search,
x-ai-grok-deep-search,
google-extended,
google-mobile-agent,
google-desktop-agent,
meta-web-indexer,
meta-external-agent,
meta-external-fetcher,
meta-facebook-bot
timezone
string

IANA timezone for date bucketing (e.g., 'America/Los_Angeles')

path
string

Filter by specific page path

pathMatch
enum<string>

Path matching mode: 'exact' for exact match, 'partial' for prefix match (default: 'partial')

Available options:
exact,
partial

Response

Default Response

request_path
string
required

Path requested by crawlers, like '/blog/some-post'

requests
number
required

Number of requests to this path by crawlers.

unique_crawlers
number
required

Number of unique crawlers that requested this path.

crawlers
string[]
required

List of crawlers that requested this path.

Example: