API Documentation
Access your HotMention data programmatically. All endpoints require an API key.
Authentication
All API requests require a Bearer token. Generate your API key in Settings → API.
Authorization: Bearer hm_your_key_here
API keys start with hm_. Keep them secret — they grant full access to your project data.
Base URL
https://hotmention.com/api/v1
Endpoints
GET
/api/v1/mentionsFetch scored mentions matching your keywords. Returns leads sorted by intent score (highest first).
🔑 Requires
Authorization: Bearer hm_your_keyQuery Parameters
keywordsstringrequired— Comma-separated keywords to search forplatformstring— Filter by platform: REDDIT, TWITTER, LINKEDIN, QUORA, THREADSscore_minnumber— Minimum intent score (default: 40)limitnumber— Max results to return, 1-100 (default: 20)sinceISO date— Only mentions after this date (default: 24h ago)Example
curl "https://hotmention.com/api/v1/mentions?keywords=referral+program,affiliate+software&score_min=50&limit=10" \ -H "Authorization: Bearer hm_your_key_here"
Response
{
"mentions": [
{
"id": "abc123",
"platform": "REDDIT",
"url": "https://reddit.com/r/SaaS/...",
"title": "Looking for a referral program tool",
"content": "We need a simple way to set up affiliate tracking...",
"author": "u/saasfounder",
"score": 87,
"scoreLabel": "HOT",
"shouldReply": true,
"shouldReplyReason": "Direct product match, high buying intent",
"draftReply": "Hey! You might want to check out...",
"competitorsFound": ["PartnerStack"],
"postedAt": "2026-02-16T08:30:00Z",
"matchedKeyword": "referral program"
}
],
"total": 42,
"plan": "GROWTH",
"limits": { "monthlyLeads": 500, "used": 39 }
}GET
/api/v1/keywordsList all active keywords for your project.
🔑 Requires
Authorization: Bearer hm_your_keyExample
curl "https://hotmention.com/api/v1/keywords" \ -H "Authorization: Bearer hm_your_key_here"
Response
{
"keywords": [
{ "id": "kw1", "term": "referral program", "createdAt": "2026-01-15T10:00:00Z" },
{ "id": "kw2", "term": "affiliate software", "createdAt": "2026-01-15T10:00:00Z" }
],
"projectName": "My SaaS"
}POST
/api/v1/keywordsAdd new keywords to your project. Subject to your plan's keyword limit.
🔑 Requires
Authorization: Bearer hm_your_keyRequest Body (JSON)
keywordsstring[]required— Array of keyword strings to addExample
curl -X POST "https://hotmention.com/api/v1/keywords" \
-H "Authorization: Bearer hm_your_key_here" \
-H "Content-Type: application/json" \
-d '{"keywords": ["CRM alternative", "best CRM for startups"]}'Response
{ "added": 2 }POST
/api/v1/keysCreate a new API key (requires session auth, not API key).
Request Body (JSON)
namestring— Label for the key (default: 'Default')Example
curl -X POST "https://hotmention.com/api/v1/keys" \
-H "Cookie: your_session_cookie" \
-H "Content-Type: application/json" \
-d '{"name": "Production"}'Response
{
"id": "key_abc123",
"key": "hm_a1b2c3d4e5f6...",
"name": "Production",
"createdAt": "2026-02-16T10:00:00Z"
}GET
/api/v1/keysList all your API keys (requires session auth).
Example
curl "https://hotmention.com/api/v1/keys" \ -H "Cookie: your_session_cookie"
Response
[
{
"id": "key_abc123",
"name": "Production",
"keyPreview": "hm_a1b2...f6",
"isActive": true,
"lastUsedAt": "2026-02-16T09:30:00Z",
"createdAt": "2026-01-10T10:00:00Z"
}
]Rate Limits & Plan Limits
| Plan | Leads/month | Keywords | Platforms |
|---|---|---|---|
| Free | 10 | 5 | |
| Starter ($49) | 100 | 10 | Reddit, X |
| Growth ($99) | 500 | 50 | Reddit, X, LinkedIn, Threads |
| Scale ($199) | 2,000 | 200 | All 5 platforms |
Error Codes
401Invalid or missing API key400Missing required parameters403Plan limit exceeded (leads or keywords)404No active project foundQuestions? Contact support@hotmention.com