Skip to main content
Track all changes, improvements, and updates to the Promptwatch API v2.

​
September 18, 2026

Search Insights (Google Search Console and Bing Webmaster)
  • GET /api/v2/search-insights/google/pages — Google clicks, impressions, and position per pathname (period=7d|30d). Paginated (page, size, default 50, max 100); response is { data, total, page, size, totalPages }.
  • GET /api/v2/search-insights/google/trend — daily Google clicks and impressions (startDate/endDate, default last 30 days, max 90)
  • GET /api/v2/search-insights/bing/pages — Bing clicks, impressions, and position per pathname (period=7d|30d). Same pagination as Google pages.
  • GET /api/v2/search-insights/bing/trend — daily Bing clicks and impressions (startDate/endDate, default last 30 days, max 90)
Requires the matching integration to be connected in the dashboard. Google uses the requested calendar window; Bing uses complete Sat–Fri weeks, so the two will not always cover the same days. An unconnected engine returns zeros or empty rows.

​
September 16, 2026

Organization usage
  • GET /api/v2/usage returns organization usage and effective limits (plan, custom overrides, and add-ons), plus a per-project breakdown of countable features including project caps (active prompts, prompt responses, analytics events, crawler logs, content generations, crawled pages, knowledge base items). Requires an organization-level API key; X-Project-Id is not required. Project-level keys receive 403 USAGE_ORG_FORBIDDEN.

​
September 15, 2026

Project events for time-series annotations
  • GET /api/v2/events returns project events grouped by UTC day (date + items) in a startDate/endDate window. Item types are action, prompts_created, and prompts_deleted. Join on date with visibility or sentiment time series. Optional filters: llmMonitorId, promptId. page/size paginate completed actions (default 200, max 200); response includes total, page, size, totalPages.

​
August 26, 2026

Featured image is a separate field
  • GET /api/v2/content and GET /api/v2/content/{id} now include featuredImageUrl. The generated featured image is no longer embedded in content markdown. Compose the image yourself if you previously parsed it out of the body.

​
July 29, 2026

competitorMentions deprecated on responses
  • GET /api/v2/responses and GET /api/v2/responses/{id}: competitorMentions is deprecated. It is still present and required, and is now derived from the same brand mentions that back brandMentions. Read brandMentions and keep the entries whose relation is DIRECT_COMPETITOR. brandMentions additionally carries each brand’s domain, visibility score, position and sentiment. competitorMentions will be removed in a future version.

​
April 21, 2026

Crawler activity trend default
  • GET /api/v2/analytics/crawlers/trend: if the crawlers query parameter is omitted, the server now queries all known AI crawler types (the full allowed set) instead of returning an empty time series. Pass crawlers when you need to limit results to a subset.

​
January 19, 2026

Documentation Launch
  • Initial public API documentation release
  • Comprehensive endpoint documentation
  • Interactive API reference
  • Getting started guides
  • Rate limits and quota information
Last updated: September 18, 2026