Keywords
List Keywords
Get keyword positions across Desktop, Mobile, AI Mode, and Maps
GET
Returns tracked keywords with current positions across all search channels, net position change, and metadata.
Path parameters
Project UUID
Query parameters
Maximum keywords to return (max: 1000)
Number of keywords to skip
Filter by device:
all, desktop, or mobileStart date for position change calculation (ISO 8601, e.g.,
2026-04-01)End date for position change calculation (ISO 8601)
Response fields
| Field | Type | Description |
|---|---|---|
desktop_position | number or null | Current Google Desktop rank |
mobile_position | number or null | Current Google Mobile rank |
ai_mode_position | number or null | Current Google AI Mode rank |
maps_position | number or null | Current Google Maps rank |
net_change | number | Sum of position changes across all channels. Positive = improved. |
featured_snippet | boolean | Whether the keyword has a featured snippet |
monthly_search_volume | number or null | Estimated monthly search volume |
last_checked | string | When positions were last scanned |