Mentions

Search Mentions

GET
/v1/mentions
AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Query Parameters

keywordId?string
source?string
Value in"bluesky" | "hackernews" | "github" | "stackoverflow" | "devto" | "reddit" | "x" | "youtube" | "news"
state?string
Value in"matched" | "classified" | "filtered" | "delivered" | "ignored" | "done"
minRelevance?integer|null
Range0 <= value <= 100
sentiment?string
Value in"positive" | "neutral" | "negative"
intent?string
q?string
since?integer|null
until?integer|null
cursor?string
limit?integer
Default25
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://api.mentio.dev/v1/mentions"
{
  "mentions": [
    {
      "id": "string",
      "source": "bluesky",
      "url": "string",
      "author": "string",
      "authorUrl": "string",
      "text": "string",
      "publishedAt": 0,
      "keywordId": "string",
      "keywordTerm": "string",
      "state": "matched",
      "relevance": 100,
      "sentiment": "positive",
      "intents": [
        "string"
      ],
      "aiNote": "string",
      "createdAt": 0
    }
  ],
  "nextCursor": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}