Skip to main content
GET
/
analytics
/
crawlers
/
top-pages
Top Crawler Pages
curl --request GET \
  --url https://server.promptwatch.com/api/v1/analytics/crawlers/top-pages \
  --header 'X-API-Key: <api-key>'
[
  {
    "request_path": "<string>",
    "requests": 123,
    "unique_crawlers": 123,
    "crawlers": [
      "<string>"
    ]
  }
]

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)

​
endDate
string<date>

End date for analytics data (YYYY-MM-DD)

​
crawlers
string[]

Filter by specific crawler keys. If omitted, crawler activity trend includes all known AI crawler types (server-side default to the full key set).

​
timezone
string

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

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.