--- title: "Social Media Monitoring API | MentionWatch" description: "A simple read-only REST API for your Mentionwatch mentions, trackings and sentiment stats. JSON, cursor pagination, included on Starter and Growth." canonical_url: "https://mentionwatch.com/features/api" meta: "og:description": "A simple read-only REST API for your Mentionwatch mentions, trackings and sentiment stats. JSON, cursor pagination, included on Starter and Growth." "og:title": "Social Media Monitoring API" "twitter:description": "A simple read-only REST API for your Mentionwatch mentions, trackings and sentiment stats. JSON, cursor pagination, included on Starter and Growth." "twitter:title": "Social Media Monitoring API" --- API # **Your mentions, in your own tools. ** Pull the posts Mentionwatch collects into a spreadsheet, a dashboard or your own scripts. Plain REST, JSON responses, and keys you control. [**Start free trial **](https://mentionwatch.com/signup) **See the endpoints ** Included on Starter and Growth · No extra cost Terminal ``` curl "https://mentionwatch.com/api/v1/mentions?sentiment=negative&since=2026-11-01" \ -H "Authorization: Bearer mwk_…" ``` ``` { "data": [ { "id": "3f6c…", "monitor_id": "b21a…", "platform": "instagram", "author": "priya.shah", "text": "Got the wrong order twice at Lumen Coffee this week…", "url": "https://www.instagram.com/p/…", "published_at": "2026-11-05T08:14:00+00:00", "sentiment": "negative", "metrics": { "likes": 31, "comments": 12, "shares": null, "views": 2100 } } ], "next_cursor": "eyJwIjoiMjAyNi0xMS0w…" } ``` Ideas ## **Build the report you actually want.** The dashboard covers most needs. The API is for the rest. ### **A weekly sheet** Append last week's mentions to a Google Sheet or Excel file for your report. ### **Complaints in chat** A small script that posts new negative mentions to your team chat after each scan. ### **Your own dashboard** Mood and volume next to sales and traffic in Looker Studio, Metabase or Grafana. ### **Keep everything** Copy every mention into your own database, for as long as you like. Reference ## **Four endpoints. That's the whole API.** Endpoints ### **GET requests, JSON back** Send your key in the Authorization header. Mentions come newest first; pass next\_cursor back for the next page. - Filter mentions by tracking, platform, mood, dates and words - Repeat a parameter or use commas for several values - Errors are JSON with a code and a plain message - GET/api/v1/mentions Posts, newest first. Filter by tracking, platform, mood, dates or words. - GET/api/v1/stats Counts by mood, platform and day for any range up to a year. - GET/api/v1/monitors Your trackings, and ones shared with you that you may export, with scan times. - GET/api/v1/me The key you're using, its permissions and your limits. Keys ### **Keys that only do what you allow** Make one key per script or app, so you can see what each one is for and switch it off without touching the others. - Read-only: nothing you send can change your account - Per-key permissions: mentions, trackings and stats - Limit a key to a few trackings, or give it all of them - Expiry of your choice, and instant revoke **Weekly report **mwk\_Q3vT…8kLmMentions, Stats · 2 trackings · Expires 3 Feb 2027Revoke **Claude Code **mwk\_a81Z…Pq0cMentions, Trackings, Stats · All trackings · Never usedRevoke Use an AI assistant? ## **Connect the same data to your AI assistant.** Claude, Cursor, VS Code, Codex, Gemini CLI and other MCP apps can search your mentions and stats for you. [**See the MCP server **](https://mentionwatch.com/features/mcp) FAQ ## **Common questions** Something else? Write to [~~support@mentionwatch.com~~](mailto:support@mentionwatch.com).
**Which plans include the API?**
Starter and Growth, at no extra cost. The free trial doesn't include API access.
**Can I create trackings or alerts through the API?**
Not yet. The API reads your trackings, mentions and stats. Trackings and alerts are set up in the dashboard.
**How fresh is the data?**
As fresh as your last scan. Scans run every 24 hours on Starter and every 12 hours on Growth, and each one collects up to the latest 30 posts per tracking. To pick up only what's new, pass the time of your last request as "collected_since".
**Are there webhooks?**
Not yet. Poll /api/v1/mentions with "collected_since" after each scan, or use email alerts for posts that need a quick reply.
**What are the rate limits?**
60 requests a minute per key, and 120 a minute and 10,000 a day per account. Every response carries RateLimit headers, and a 429 tells you how many seconds to wait.
**How are keys kept safe?**
Each key is shown once and stored only as a one-way hash, so even we can't read it back. You pick what it can read and which trackings, it expires when you choose, and you can revoke it at any time. We email you whenever a key is created.
Pricing ## **Small plans for small brands.** Monthly billing, no contracts, cancel in the billing portal whenever you like. Every plan includes unlimited team members. Start with a 14-day trial, no credit card needed. ### **14-Day Trial** TRIAL Try it out for yourself! **Free**for 14 days [**Start free trial**](https://mentionwatch.com/signup?plan=1) Up to 80 mentions during the trial Up to 30 posts per tracking per scan. - Unlimited team members - Instagram, TikTok - 1 keyword or hashtag - Weekly scan cycle - 3 months of history ### **Solo** For the solo entrepreneur **$5**first month Then $12 per month. Cancel anytime. [**Choose Solo**](https://mentionwatch.com/signup?plan=4) Up to 900 mentions a month Up to 30 posts per tracking per scan. - Unlimited team members - YouTube, Instagram, TikTok, X - 1 keyword or hashtag - 24-hour scan cycle - 3 months of history ### **Starter** POPULAR For serious individuals. **$29**per month Code **EARLYBIRD** takes 20% off your first month. For the first 50 customers. [**Choose Starter**](https://mentionwatch.com/signup?plan=2) Up to 3,000 mentions a month Up to 30 posts per tracking per scan. - Unlimited team members - YouTube, Instagram, TikTok, X - 3 keywords or hashtags - 24-hour scan cycle - 3 months of history - API and MCP access ### **Growth** For scaling projects. **$79**per month [**Choose Growth**](https://mentionwatch.com/signup?plan=3) Up to 16,500 mentions a month Up to 30 posts per tracking per scan. - Unlimited team members - YouTube, Instagram, TikTok, X, Facebook - 8 keywords or hashtags - 12-hour scan cycle - 3 months of history - API and MCP access ## Sitemap See the full [sitemap](/sitemap.md) for all pages.