Skip to main content
GET
/
posts
List posts
curl --request GET \
  --url https://mentioned.to/api/v1/posts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "reddit_id": "<string>",
      "subreddit": "<string>",
      "title": "<string>",
      "selftext": "<string>",
      "author": "<string>",
      "url": "<string>",
      "score": 123,
      "num_comments": 123,
      "created_utc": "<string>",
      "permalink": "<string>",
      "matched_keywords": [
        "<string>"
      ],
      "mentioned_competitors": [
        "<string>"
      ],
      "is_answered": true,
      "archived": true,
      "skipped": true,
      "priority": "high",
      "urgency": "urgent"
    }
  ],
  "count": 123
}

Authorizations

Authorization
string
header
required

API key from Settings > API. Format: rm_live_xxx

Query Parameters

keyword_id
integer

Filter by keyword ID

subreddit
string

Filter by subreddit name

priority
enum<string>

Filter by priority level

Available options:
high,
medium,
low
answered_status
enum<string>

Filter by answered status

Available options:
answered,
unanswered
has_competitors
boolean

Only posts mentioning competitors

include_archived
boolean

Include archived posts

sort_by
enum<string>

Sort field

Available options:
priority,
urgency,
date,
score,
comments
sort_order
enum<string>

Sort direction

Available options:
asc,
desc

Full-text search query

Response

Successful response

data
object[]
count
integer