Social monitoring API
Bring social monitoring data into your own tools.
Pull curated brand mentions, competitor conversations, sentiment and buyer-intent signals into dashboards, CRMs and internal workflows.
GET /alert?platform=linkedin
Authorization: Basic key-xxxxxxxxxxxxxxxx{
"platform": "linkedin",
"keyword": "Northstar",
"content": "Looking for a payments tool...",
"goal": "leads",
"sentiment": "neutral",
"score": 9,
"created_at": "2026-08-28T09:42:00Z"
}Build on the conversations that matter.
Use curated Alertly alerts inside the systems where your marketing, sales, research and operations teams already work.
Custom dashboards
Bring Alertly alerts into internal reporting or client dashboards without building a monitoring pipeline first.
CRM enrichment
Attach relevant social conversations and buying signals to the accounts or leads your team already manages.
Competitor reporting
Feed competitor mentions and customer conversations into research, reporting and market-intelligence workflows.
Internal alert workflows
Route high-value alerts into internal tools, automations, support queues or operational systems.
Useful data in. Less cleanup out.
Alertly exposes the output of your monitoring pipeline — not an unfiltered firehose of every matching post.
Relevance filtering
Low-value keyword matches can be filtered, leaving your workflow with cleaner inputs.
Intent and sentiment
Use the intent, sentiment and relevance data available in your alerts to sort and route useful conversations.
One normalized alert stream
Work with alerts across supported sources without maintaining a separate monitoring integration for each platform.
Your existing monitors
The API exposes alerts generated by the keywords, sources and monitoring configuration you already manage in Alertly.
API documentation
Start pulling alerts in minutes.
Create a key, call GET /alert, then use query parameters to return the alerts your workflow needs.
Generate an API key
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.
Fetch your alerts
Send your API key in the header, then filter results with query parameters.
Authorization: Basic key-xxxxxxxxxxxxxxxxGET https://api.usealertly.com/alert| 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. Defaults to 250 when omitted; values above 250 are capped at 250. |
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. |
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"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]);Work with the response
Each response contains matching alert records and the total number of results.
{
"data": {
"results": [
{
"id": "…",
"title": "…",
"content": "…",
"url": "…",
"platform": "reddit",
"keyword": "Alertly",
"status": "unread",
"filtered": false,
"goal": "leads",
"sentiment": "neutral",
"score": 7,
"time_ago": "3 hours ago"
}
],
"total": 123
}
}
Build with Alertly.
Bring relevant social conversations into the tools and workflows your team already uses.
Social monitoring API FAQs
Answers to common questions about using Alertly alerts in your own tools.
What is a social monitoring API?
What platforms does Alertly monitor?
Can I filter mentions by platform or sentiment?
Can I use the API for competitor monitoring?
Is Alertly a raw social media firehose API?
How do I get an API key?
alert.read scope. Then send it with your request using the Authorization: Basic header.