Social Listening API for AI Agents

Filter the signal

Ask for the platform, keyword, tags, relevance, and date range you need.

curl "https://api.mentionkit.com/api/v1/mentions?platform=reddit&relevance=4,5&tags=comparing,alternatives" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get structured mention data

Send clean JSON to an agent, CRM, dashboard, or internal workflow.

{
  "items": [{
    "platform": "REDDIT",
    "keywordValue": "mentionkit",
    "authorHandle": "buildwithsam",
    "text": "What social listening API works well with agents?",
    "relevance": 5,
    "tags": ["comparing", "alternatives"],
    "sourceUrl": "https://reddit.com/r/SaaS/comments/example",
    "sourceCreatedAt": "2026-07-31T01:24:00.000Z"
  }],
  "nextCursor": 2048
}

A social media monitoring API built for agents

Give an agent the context it needs to find useful conversations, rank the signal, and return the source data for review.

Collect public mentions. Track brand names, competitors, buyer questions, and category terms across supported sources.
Filter the feed. Query by project, platform, keyword, date, relevance score, and classification tags.
Send the data where it belongs. Pull JSON through the API or route new matching mentions to your webhook.

The same workflow can act as a brand monitoring API, brand mentions API, or mention tracking API. Your app decides what happens next.

Social listening data API

One data shape across your public social channels

Monitor LinkedIn, Reddit, X, TikTok, YouTube, Bluesky, Hackernews, GitHub, and more supported sources without maintaining a different integration for each one.

Reddit

Track posts and comments from communities.

Catch live threads.

LinkedIn

Monitor posts where B2B buyers hang out.

TikTok

Track Tiktok videos for brand mentions.

Bluesky

Find threads and engage before conversations cool down.

Hackernews

Monitor technical discussions around products, alternatives, and stack decisions.

YouTube

Track creator reviews, comparison videos and more.

GitHub

Find product mentions across public issues, discussions, and repositories.

Useful fields for search, monitoring, and classification

Each API response gives your workflow the mention text and the context needed to sort it.

Source context: Platform, author handle, source time, post ID, and captured text.
Tracking context: Project name and ID, matched keyword, and Mentionkit mention ID.
Signal context: Relevance score and tags for positive, negative, comparing, alternatives, promotional, and insight mentions.
Workflow context: Review status, generated comment, cursor, and sort order.

Use this social listening data API to power an internal dashboard, enrich a CRM record, prepare an agent brief, or keep a customer support queue current.

How the real-time social media monitoring API works

Mentionkit watches for your keywords on an ongoing schedule. Timing depends on the source.

Add the terms you care about. Start with your brand, competitors, and clear buyer-intent phrases.
Let Mentionkit monitor supported sources. New public matches flow into one mention feed and receive relevance data.
Pull or receive new data. Query the REST API when your app needs it, or use a webhook after scheduled monitoring runs.

Webhook delivery is not an instant firehose. Monitoring times vary by platform, and backfilled mentions do not trigger webhooks.

Choose REST API, webhooks, or MCP

Use one connection or combine them around your workflow.

REST API: Best when your app needs filtered queries, pagination, and predictable JSON responses.
Webhooks: Best when your server should receive new mentions after a monitoring run.
MCP server: Best when an AI agent should inspect, shortlist, and work with mention data through a context-first flow.

Start with the API overview, then open the mentions endpoint and webhook guide when you are ready to connect.

Social listening API FAQ

Clear answers about coverage, delivery, filters, authentication, and AI-agent access.

What can I build with the Mentionkit social listening API?

You can build brand monitoring dashboards, lead alerts, research tools, support queues, and AI-agent workflows on top of Mentionkit mention data.

Use the REST API to fetch data, or use webhooks to send new mentions into your system after a monitoring run.

Which social platforms can I monitor?

Mentionkit monitors public conversations across LinkedIn, Reddit, X, TikTok, YouTube, Bluesky, Hackernews, GitHub, and more supported sources.

Coverage and monitoring times vary by platform.

Is this a real-time social media monitoring API?

Mentionkit runs ongoing monitoring and can send new matching mentions to your webhook after a scheduled platform check.

Delivery is not an instant firehose. Monitoring times vary by platform, and backfilled mentions do not trigger webhooks.

Can I filter and classify brand mentions?

Yes. Filter mentions by project, platform, keyword, category, date, relevance score, and tags such as positive, negative, comparing, alternatives, promotional, and insight.

Each result includes structured fields you can pass to your own model or workflow.

How do AI agents connect to Mentionkit?

Agents can call the REST API with a Bearer token and work with the returned JSON.

You can also connect the Mentionkit MCP server when your AI client supports remote MCP over HTTP.

How do I authenticate API requests?

Pass your Mentionkit API key in the Authorization header as a Bearer token.

You can find the key in your Mentionkit API key and webhook settings.

Build your first mention workflow

Add your keywords, collect public conversations, and connect the data to your agent or app.

Start free trial

Real-time social listening API