API, webhooks & MCP on every plan

Social listening APIfor programmatic mention monitoring

Built for product, marketing, and engineering teams: monitor mentions across Reddit, X, LinkedIn, news, podcasts, and 10+ more sources with one endpoint, structured JSON, and webhooks.

No credit card • Full API access during trial • 5k free mentions
RequestPOST /api/v2/mentions

curl -X POST api.octolens.com/v2/mentions \

  -H "Authorization: Bearer $KEY" \

  -d '{

    "sources": ["reddit", "twitter", "news"],

    "sentiment": ["Negative"],

    "limit": 10

  }'

Response200 OK

{

  "data": [{

    "source": "reddit",

    "body": "Their checkout is broken again…",

    "sentiment": "Negative",

    "relevance": "relevant",

    "tags": ["bug_report"]

  }, …]

}

Trusted by brands people talk about online

Cursor logo
Sentry logo
Vercel logo
PostHog logo
Railway logo
Render logo
Supabase logo
PlanetScale logo
Prisma logo
Juicebox logo
Modal logo
Metabase logo
Tally logo
Lovable logo
Medusa logo
CodeRabbit logo
Railway logo

"Built on top of the Octolens API, I use Railway as a service to pipe all of the mentions to different channels. Then there's a cron job that does a daily digest for us."

Mahmoud Abdelwahab profile picture
Mahmoud Abdelwahab
Senior DevRel Engineer, Railway
Why one API

A Practical Alternative to Scraping, Direct APIs, and Full Suites

If you need mention monitoring data inside your own product or workflows, Octolens gives you one API for multi-source ingestion without scraping infrastructure or enterprise procurement cycles.

Managing Multiple Social APIs

  • DIY scraping means constant anti-bot breakages and maintenance
  • Official platform APIs use different auth, quotas, and response formats
  • Full social suites can be heavyweight when you only need API-first workflows
  • Teams still have to normalize data and remove irrelevant mentions
  • Real-time delivery and alert pipelines add more engineering overhead

With Octolens API

  • One API key and one schema across supported sources
  • REST API, webhooks, and MCP on every paid plan
  • Usage-based flex mentions from $0.01 on Scale
  • AI relevance filtering and sentiment included in each mention payload
  • Push mentions into your stack instead of building ingestion infrastructure
Code example

Simple API For Clean Social Listening Data

One POST to get structured mentions from every platform. Sentiment, relevance, tags, and pagination built in.

const resp = await fetch("https://app.octolens.com/api/v2/mentions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    filters: {
      sources: ["reddit", "twitter", "linkedin"],
      sentiment: ["Positive", "Negative"],
    },
    limit: 10,
  }),
});

const { data: mentions } = await resp.json();
200 OK
Response
{
  "data": [
    {
      "id": 482731,
      "source": "reddit",
      "body": "Just tried Octolens and it solved our monitoring problem...",
      "author": "developer_mike",
      "relevance": "relevant",
      "sentiment": "Positive",
      "tags": ["feature_request", "pricing"],
      "keywords": [{"id": 42, "keyword": "social listening"}]
    },
    {
      "id": 482732,
      "source": "twitter",
      "body": "Switching to @octolens was the best decision we made...",
      "author": "startup_cto",
      "relevance": "relevant",
      "sentiment": "Positive",
      "tags": ["competitor_mention"],
      "keywords": [{"id": 42, "keyword": "social listening"}]
    }
  ],
  "pagination": { "nextCursor": "eyJwYWdlIjogMn0=" }
}
What you get

Unified Social Listening API For All Platforms

RESTful endpoints. Webhook delivery. MCP server for AI agents. Python and Node SDKs coming soon.

All Platforms, One Endpoint

Reddit, Twitter, LinkedIn, Hacker News, GitHub, YouTube, TikTok, Bluesky, DEV, Product Hunt, podcasts, and newsletters.

No need to integrate and maintain 10+ different APIs.

Real-Time Webhooks→

Push delivery to your systems. New mentions hit your endpoint within minutes of being posted.

Configure filters to only receive the mentions that matter.

AI Filtering Built In

Relevance scoring, sentiment analysis, and deduplication happen at the API level.

"Octolens' AI-assessments helped weed out a lot of the noise" — Prisma

MCP Server→

Connect Octolens to Claude, Cursor, or any MCP-compatible AI agent for real-time social data.

Your AI agents can query mentions, analyze sentiment, and respond.

Use cases

What Developers Build With Our Social Listening API

Your data, your workflows. No locked-in dashboards.

Power AI Agents

Feed real-time social data to Claude, GPT, or custom AI agents. Use MCP server for natural language queries or REST API for batch processing.

Ask your agent: "What are people saying about our new feature on Reddit?"

Build Custom Dashboards

Pull mention data into your BI tool, Notion, or internal dashboard. Track sentiment trends, engagement metrics, and share of voice.

Schedule daily syncs to BigQuery or Snowflake for historical analysis.

Use in Your SaaS

Embed social listening into your product. Show customers what people are saying about their brand, surface relevant discussions, or add social proof widgets.

Add a 'Brand Mentions' tab to your marketing dashboard that pulls live data from our API.

API Included on All Plans

No enterprise upsell. No premium tier for API access.

REST API access
Webhooks
MCP server
AI filtering

14 platforms included

X
Reddit
LinkedIn
YouTube
TikTok
Bluesky
GitHub
Hacker News
DEV
Stack Overflow
Podcasts
Newsletters
News
$159/month

Billed annually. 15,000 mentions included — more can be added flexibly.

Comparison

How Octolens Compares by Integration Path

Choose the model that matches your goals: control with DIY, platform depth with official APIs, suite workflows, or one endpoint for multi-source monitoring.

FeatureOctolensDIY ScrapingOfficial APIsFull Suites
Programmatic mention monitoringBuild it yourselfPer-platform only
One schema across sourcesVaries
REST API + webhooks + MCPVaries
Usage pricing clarity$0.01 per flex mention (Scale)Infra + ops costs varyVaries by platformVaries by contract
Maintenance ownershipYou own itYou own itVendor-managed
AI relevance + sentiment includedVaries by plan
Customer stories

Real results from teams using Octolens

"Built on top of the Octolens API, I use Railway as a service to pipe all of the mentions to different channels. Then there's a cron job that does a daily digest for us."

Mahmoud Abdelwahab
Mahmoud Abdelwahab
Senior DevRel Engineer, Railway
40% MoM
Signup growth correlated with mentions
13
Platforms monitored, up from 1

API Questions Answered

No. API, webhooks, and MCP server are included on all plans, starting at $159/month (billed annually). We don't gatekeep developer features behind enterprise pricing.

Reddit, Twitter/X, LinkedIn, Hacker News, GitHub, YouTube, TikTok, Bluesky, DEV, Product Hunt, Stack Overflow, podcasts, newsletters, and more. All accessible through a single endpoint.

Monthly subscription includes a mention quota (15,000 on Pro, 50,000 on Scale). Beyond that, flex mentions kick in automatically at $0.013 per mention on Pro and $0.01 on Scale — set a monthly spend cap or disable them in settings.

Yes. Connect Octolens to Claude, Cursor, Windsurf, or any MCP-compatible AI agent. Your AI can query mentions, analyze sentiment, and work with social data in natural language.

Yes. Configure webhooks to push new mentions to your endpoint as they're detected. Filter by source, sentiment, relevance score, or engagement metrics. Webhooks are also directly compatible with Discord.

Use direct platform APIs if you need platform-specific write actions like posting, replying, or moderation. Use Octolens when your goal is cross-platform mention monitoring with one integration and one schema.

Each mention includes: source platform, author info, full content, URL, timestamp, sentiment label, relevance score (AI-generated), engagement metrics, and any tags. Paginated responses with cursor support.

Generous rate limits that scale with your plan. Most customers never hit them. If you're building something high-volume, reach out and we'll work with you.

Python and Node SDKs are in development. For now, the REST API is straightforward to use with any HTTP client. We also support Zapier, n8n, and Make for no-code integrations.

7-day free trial

Start listening to your customers today

Join 1,000+ companies using Octolens for social listening.

No credit card required · API access on all plans · Cancel anytime