HotMentionHotMention

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/mentions

Fetch scored mentions matching your keywords. Returns leads sorted by intent score (highest first).

🔑 Requires Authorization: Bearer hm_your_key

Query Parameters

keywordsstringrequiredComma-separated keywords to search for
platformstringFilter by platform: REDDIT, TWITTER, LINKEDIN, QUORA, THREADS
score_minnumberMinimum intent score (default: 40)
limitnumberMax results to return, 1-100 (default: 20)
sinceISO dateOnly 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/keywords

List all active keywords for your project.

🔑 Requires Authorization: Bearer hm_your_key

Example

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/keywords

Add new keywords to your project. Subject to your plan's keyword limit.

🔑 Requires Authorization: Bearer hm_your_key

Request Body (JSON)

keywordsstring[]requiredArray of keyword strings to add

Example

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/keys

Create a new API key (requires session auth, not API key).

Request Body (JSON)

namestringLabel 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/keys

List 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

PlanLeads/monthKeywordsPlatforms
Free105Reddit
Starter ($49)10010Reddit, X
Growth ($99)50050Reddit, X, LinkedIn, Threads
Scale ($199)2,000200All 5 platforms

Error Codes

401Invalid or missing API key
400Missing required parameters
403Plan limit exceeded (leads or keywords)
404No active project found
Questions? Contact support@hotmention.com