Want a free personalized recommendation for your software stack?Get yours
That Marketing Buddy
Home/API/PromptWatch

PromptWatch API

Yes. PromptWatch publishes a public REST API with both auth. See promptwatch.com/docs for pricing details.

Auth: bothOpenAPI specWebhooks: unknownMCP also availableLLMs: Claude, ChatGPT
Public REST API documentedAgent-readiness 8/10
Data from Buddy's database, auto-rechecked weekly

What is the PromptWatch API?

PromptWatch ships a REST API in two versions (v2 recommended, v1 legacy) at https://server.promptwatch.com, authenticated with an X-API-Key header generated under Settings > API Keys. The v2 surface is broad: roughly 70 endpoints spanning prompts (including bulk create and delete), responses, citations, visibility and sentiment time series, competitor analysis, content and content-gap analytics, query fanouts, personas, monitors, brands, projects, tags, action items, site health, sitemap status, and the crawler and visitor analytics.

The developer experience is properly done: an OpenAPI spec at promptwatch.com/docs/v2/openapi.json (plus a v1 spec), a Postman collection, markdown-served doc pages with an llms.txt index, and published rate limits across three windows (hourly quota, per-minute burst, per-second burst), from about 150 requests a minute on entry plans to 834 on Enterprise, with a universal 1,000/minute per-IP cap.

The standout policy: API access is included on every plan, including the free Explore tier. Rate limits scale with the plan, but access itself is never gated. One hygiene note: the rate-limit docs still reference older plan names (Solo, Startup) that the current pricing page (Essential, Professional, Business) has replaced, so map limits by tier position rather than name.

For the broader picture: PromptWatch review, full pricing breakdown, .

HOOK IT TO YOUR STACK

Real PromptWatch API calls you'll write

promptwatch-apirest
#Pull the latest data from PromptWatch
GET/v1/records?limit=10&sort=-created_at
200 OK · 10 records
Most recent entry2 min ago
Records this week147
API calls today1,832
Rate limit remaining8,168 / 10k
Schedule via cron, pipe results.
promptwatch-apirest
#Push a new record with custom metadata
POST/v1/records
201 Created · record_id: r_5a7
Validationpassed
Webhooks triggered2
Stored size1.2 KB
promptwatch-apirest
#Subscribe to webhook events
POST/v1/webhooks
201 Created · webhook_id: wh_3f
Signing secretwhsec_••••
Eventsrecord.created
Statusactive
TMB SCORE FOR PromptWatchAuth: bothAgent fit: 8/10
Read review →

Endpoints illustrative. Confirm exact paths against the live API docs before integrating.

Pricing, limits, and integration

Access costs nothing extra at any tier: the REST API and MCP server are included on every plan, and the free Explore tier gets both at entry-level limits. That makes PromptWatch one of the only GEO tools where an agent stack can be built and tested before any money changes hands. Keys are generated self-serve under Settings > API Keys and passed as X-API-Key (REST) or Authorization: Bearer (MCP).

Rate limits are published rather than discovered in production, across three windows: an hourly quota, a per-minute burst and a per-second burst, shared per organization between the REST API and the MCP server. The documented ladder runs from about 150 requests a minute on entry plans to 334 on Business and 834 on Enterprise, with a separate universal cap of 1,000 requests a minute per IP. Note the docs' plan names lag the pricing page (Solo and Startup versus today's Essential and Professional), so confirm your tier's exact numbers in-app.

The practical agent pattern: authenticate Claude over OAuth for interactive work (querying visibility trends, competitor movements and citation sources conversationally), give automation a scoped API key for scheduled jobs (syncing prompt sets, pulling time series into your warehouse, updating action items), and let the write tools handle prompt lifecycle management so your tracking setup stays in code. The recipes and skills pages in the MCP docs sketch several of these workflows ready-made.

How much does the PromptWatch API actually cost?

Verify on docs

PromptWatch publishes an API, but per-tier gating wasn't extracted automatically.

  • Most likely scenario: API access is either included in all paid plans, or it's gated to higher tiers and we need to verify on the live docs page.
  • Until verified, treat the question "which plan unlocks the API" as open. Don't budget on the assumption it's free with the cheapest paid plan.

API at a glance

Auth method
both
SDK languages
OpenAPI spec
Webhooks
not available
Structured outputs
yes

Which AI clients can read PromptWatch data?

Not every AI assistant supports MCP natively. Here's the per-client picture for PromptWatch specifically.

ClientSupportNotes
Claude (Desktop/Web)Native MCPOAuth browser-consent flow, no credentials to paste; or npx mcp-remote with a Bearer API key.
Claude CodeNative MCPclaude mcp add --transport http promptwatch https://server.promptwatch.com/mcp with an Authorization header, or the OAuth flow.
CursorNative MCPDocumented setup: server URL plus Authorization: Bearer YOUR_API_KEY header.
ChatGPTAPI-only (custom code)No documented ChatGPT MCP path; use the REST API from custom GPT actions or code.
n8nAPI-only (custom code)No native node found; the REST API with X-API-Key auth covers the same surface for workflow automation.

PromptWatch also has an MCP server

If you're wiring PromptWatch into Claude / Cursor / Codex, the MCP server is usually less code than the REST API.

See PromptWatch MCP page

What you can build with the PromptWatch API

Three personas, three different shapes of build. Pick the row that matches how you actually ship.

SOLO DEV / FOUNDER

Glue PromptWatch into your daily workflow

  • Pull a digest of fresh activity into your morning Slack
  • Trigger a one-off backfill when something looks off
  • Pipe data into your own SQLite for ad-hoc queries
Effort: A weekend, one Node or Python script
AGENCY / CONSULTANT

Sell PromptWatch reporting at scale

  • White-label PromptWatch data into client-branded dashboards
  • Run scheduled multi-account reports without logging into the PromptWatch UI
  • Cross-reference with the rest of the client's stack (CRM, analytics, ad spend)
Effort: 1-2 weeks, hits multi-tenant auth quickly
IN-HOUSE ENGINEER

Production pipelines for PromptWatch

  • Real-time sync into your warehouse on a cron
  • Custom alerts the dashboard's built-in alerting can't express
  • Backfill + idempotency handling for PromptWatch data older than the dashboard exposes
Effort: Multi-week project, expect rate-limit tuning

Quickstart template

# Starter template — endpoint paths and SDK package names come from
# the PromptWatch API docs: https://promptwatch.com/docs

curl -X GET "https://promptwatch.com/<your-endpoint>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json" | jq .

Template only. Endpoint paths, exact base URL, and auth header format come from promptwatch.com/docs.

Limits and gotchas

  • OpenAPI is published — auto-generated clients work out of the box. Saves writing wrappers by hand.
  • No official SDK detected. Plan on hitting the API directly with your HTTP client of choice.
  • Rate limits: always read the docs page before scaling — the published limit is usually lower than the practical one and overages can be expensive.
  • Structured JSON outputs — agent-friendly, no scraping required.
8/10

Agent-readiness verdict

A broad, well-documented API with an OpenAPI spec, Postman collection, published three-window rate limits and markdown docs, included on every plan down to the free tier. Minor doc drift on plan names and no labeled bulk-export endpoint keep it at 8 out of 10 rather than higher.

Best agent stack in the GEO category: official remote MCP server (server.promptwatch.com/mcp, streamable HTTP) with OAuth browser-consent auth or API key, 59 tools including write operations (create/update/delete prompts, monitors, brands, personas, generate content). REST API v2 with ~70 endpoints, OpenAPI spec, Postman collection, published three-window rate limits. MCP and API access on every plan including the free Explore tier. llms.txt + markdown docs + MCP recipes and skills guides.

Official MCP server (remote HTTP, OAuth)Write-capable MCP toolsPublic API on all plans incl. freeOpenAPI spec publishedRate limits documentedllms.txt published

PromptWatch API FAQ

Does PromptWatch have a public API?+
Yes — REST API at promptwatch.com/docs, auth via both.
What auth does the PromptWatch API use?+
Both API key (server-side) and OAuth (delegated/user-auth).
Is there an OpenAPI / Swagger spec I can auto-generate clients from?+
Does PromptWatch support webhooks?+
Not available based on current data.
Should I use the API or the MCP server for Claude / Cursor / Codex?+
Prefer the MCP server for agent workflows — it's less code and pre-handles auth flows. Use the REST API for scheduled jobs, dashboards, and anything outside an LLM-driven flow.

Sources

Joonas Rotko
Joonas RotkoAuthor & Founder of That Marketing Buddy

10+ years in digital marketing. I review marketing software for AI-stack fit: real pricing, MCP and API support, and how cleanly each tool drops into an AI agent workflow, cross-checked against verified data and real user feedback.

PromptWatch

Try PromptWatch
WEEKLY NEWSLETTER

The marketing tools worth your money, scored for AI agent readiness

Every week I score the tools for MCP, API, and agent-readiness, then email you the ones that actually deliver, what plugs into Claude and Cursor, the pricing changes, and what to skip. No fluff, no daily spam.

Join for free. One email a week, unsubscribe anytime.