List Ads
Paginated list of sponsored ads captured in AI answers (Ads Radar)
Authorizations
API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.
Query Parameters
Page number (1-based)
x >= 1Page size
1 <= x <= 100Search within ad title, description, advertiser name, or domain
Filter by prompt IDs. Repeat for multiple values.
Field to sort by
createdAt, positionInResponse, advertiserName, rootDomain Sort order
asc, desc Filter ads captured from this date (ISO 8601)
Filter ads captured until this date (ISO 8601)
Filter by LLM model IDs. Repeat for multiple: models=x&models=y
Filter by prompt type. Repeat for multiple values.
ORGANIC, BRAND_SPECIFIC, COMPETITOR_COMPARISON Filter by prompt intent. Repeat for multiple values.
BRANDED, INFORMATIONAL, NAVIGATIONAL, COMMERCIAL, TRANSACTIONAL Filter by advertiser root domain. Repeat for multiple values.