What platforms does Alertly monitor?

Alertly currently monitors Reddit, X (Twitter), LinkedIn, Bluesky, YouTube, and Google News. The API lets you fetch alerts from supported platforms and filter them by platform when needed.

Can I filter mentions by platform or sentiment?

Yes. You can filter API results by platform, keyword, timeframe, unread status, sentiment, and other available query parameters.

Can I use the API for competitor monitoring?

Yes. You can create competitor keywords in Alertly, then use the API to pull competitor mentions, complaints, comparison conversations, and switching signals into your own tools.

Is Alertly a raw social media firehose API?

No. Alertly focuses on curated social monitoring alerts rather than raw firehose access. It is designed for teams that want high-signal conversations they can review, report on, and act on.

How do I get an API key?

Create an API key in your Alertly account and include the alert.read scope. Then send it with your request using the Authorization: Basic header.

Can I use Alertly data in reporting dashboards?

Yes. You can fetch Alertly alerts through the API and use them in internal dashboards, weekly reports, BI pipelines, or social monitoring workflows.

Social Monitoring API

Pipe social mentions into every workflow

Pull high-signal social mentions, competitor alerts, sentiment, and buyer-intent conversations into your dashboards, CRMs, reports, and internal workflows.

Start Free Trial

High-signal alerts

Get curated social monitoring data instead of a raw stream of noisy posts.

Flexible filters

Filter by platform, keyword, timeframe, sentiment, status, and relevance.

What is a social monitoring API?

A structured way to send the social conversations your team tracks into the tools where work happens.

Track conversations

Collect alerts for brand mentions, competitor references, category keywords, and customer pain points.

Filter the noise

Use platform, keyword, sentiment, intent, status, and timeframe filters to return the alerts you actually need.

Sync to your stack

Pull social monitoring data into dashboards, CRMs, BI reports, Slack workflows, or internal tools.

What you can build with social monitoring data

Turn social conversations into systems your marketing, sales, PR, and product teams can act on.

Custom monitoring dashboards

Show brand mentions, competitor alerts, sentiment, and high-intent conversations in your own interface.

CRM enrichment

Send relevant conversations into your CRM so sales can see what prospects are asking for before outreach.

Brand monitoring reports

Build recurring reports for reputation, PR, customer feedback, and share-of-conversation analysis.

Internal alert workflows

Route specific social alerts to Slack, ops tools, support queues, or review workflows.

Why use Alertly's Social Monitoring API?

Alertly is built for teams that need useful social signals, not a giant firehose of low-quality data.

Curated before it reaches you

Alertly filters noisy posts and surfaces social alerts that match your keywords, goals, and relevance rules.

Built-in sentiment and score

Use sentiment and relevance scores to sort, prioritize, and route the conversations worth acting on first.

Simple endpoint

Fetch alerts from one endpoint with practical filters for platform, timeframe, unread status, keyword, and sentiment.

Developer-friendly access

Create an API key in the app, use the alert.read scope, and start pulling data into your workflow.

Common social monitoring API workflows

A few practical ways teams use Alertly alerts outside the app.

Send hot conversations to sales

Fetch unread alerts with high relevance, then create CRM tasks or Slack messages for sales and growth teams.

Build competitor reports

Pull weekly competitor mentions, filter by sentiment, and summarize trends for marketing, PR, or leadership.

Power an internal dashboard

Display recent social alerts by platform, keyword, sentiment, and timeframe inside your team's own dashboard.

How the Social Monitoring API works

Create a key, call GET /alert, then use query parameters to return the exact alerts your workflow needs.

Step 1 — Generate an API key

Create an API key with the scope alert.read.

Step 2 — Make your request

Call GET /alert and filter by platform, keyword, status, timeframe, sentiment, and intent.

Generate an API key

Create a key in the app, then copy it.

Go to Account → API Keys in the app, click New, and make sure the key includes the scope alert.read.

Keys are shown masked by default — use Reveal to copy the full value.

Create API key

Tip: Treat API keys like passwords. Store them in a secret manager and rotate/revoke them if they’re ever exposed.

Fetch social monitoring alerts

Send your API key in the header, then filter results with query params.

Authentication header

Authorization: Basic key-xxxxxxxxxxxxxxxx

Request

GET https://api.usealertly.com/alert

Query parameters

Param	Type	Notes
`platform`	string	Comma-separated platforms (e.g. `reddit,x,linkedin`).
`keyword`	string	Comma-separated keyword IDs to filter by.
`offset`	number	Pagination offset (e.g. `0`, `50`).
`limit`	number	Page size (e.g. `25`, `100`).
`search`	string	Searches `title` and `content` (SQL LIKE).
`include_filtered`	boolean	Set `true` to include filtered alerts. Default: excludes filtered.
`filtered_only`	boolean	Set `true` to return only alerts marked as filtered.
`unread_only`	boolean	Set `true` to only return unread alerts.
`timeframe`	string	`today`, `yesterday`, `this_week`, `this_month`, or `last_<N>_days` (e.g. `last_7_days`). Use `all` to disable.
`sentiment`	string	Filter by `positive`, `neutral`, or `negative`. Supports comma-separated values. Use `all` to disable.
`intent`	string	Filter by alert goal/intent. Supports comma-separated values. Use `all` to disable.

Example (curl)

curl -G "https://api.usealertly.com/alert" \
  -H "Authorization: Basic key-xxxxxxxxxxxxxxxx" \
  --data-urlencode "unread_only=true" \
  --data-urlencode "timeframe=last_7_days" \
  --data-urlencode "sentiment=positive,neutral" \
  --data-urlencode "limit=25"

Example (JavaScript)

const API_KEY = "key-xxxxxxxxxxxxxxxx";

const params = new URLSearchParams({
  platform: "reddit,x",
  unread_only: "true",
  timeframe: "last_30_days",
  sentiment: "positive,neutral",
  limit: "50",
});

const res = await fetch("https://api.usealertly.com/alert?" + params.toString(), {
  headers: { Authorization: "Basic " + API_KEY },
});

if (!res.ok) throw new Error(await res.text());

const { data } = await res.json();
console.log(data.total, data.results?.[0]);

Response shape

{
  "data": {
    "results": [
      {
        "id": "…",
        "title": "…",
        "content": "…",
        "url": "…",
        "platform": "reddit",
        "keyword": "Alertly",
        "status": "unread",
        "filtered": false,
        "goal": "lead",
        "sentiment": "neutral",
        "score": 7,
        "time_ago": "3 hours ago"
      }
    ],
    "total": 123
  }
}