Search public Reddit posts by keyword, newest first, and return normalized post, subreddit, engagement, and source data.
Endpoint
- Path:
/api/v1/reddit/search-posts - Cost: 1 credit per successful request
Query parameters
| Name | Required | Description | Example |
|---|---|---|---|
query | Yes | The keyword or phrase to search for. | social listening |
exact | No | Search for the exact phrase by wrapping the query in double quotes. Defaults to true. Set to false to send the query unchanged. | true |
raw | No | Include the unchanged provider response in the raw field. Defaults to false. | true |
curl --get 'https://api.sociallisteningapi.com/api/v1/reddit/search-posts' \
--data-urlencode 'query=social listening' \
--data-urlencode 'exact=true' \
--data-urlencode 'raw=true' \
--header 'x-api-key: YOUR_API_KEY'Responses
{
"success": true,
"platform": "reddit",
"endpoint": "/api/v1/reddit/search-posts",
"data": {
"items": [
{
"id": "1abc234",
"platform": "reddit",
"url": "https://www.reddit.com/r/marketing/comments/1abc234/example/",
"content": {
"title": "How are you using social listening?",
"text": "A practical guide to social listening for small teams.",
"media_urls": [],
"thumbnail_url": null
},
"author": {
"id": "author_123",
"username": "alex",
"display_name": "Alex Morgan",
"avatar_url": "https://example.com/avatar.jpg",
"verified": false
},
"engagement": {
"views": 1200,
"likes": 48,
"comments": 7,
"shares": 3,
"saves": null
},
"published_at": "2026-08-05T01:30:00.000Z",
"ext": {
"subreddit": "marketing",
"permalink": "/r/marketing/comments/1abc234/example/",
"upvote_ratio": 0.94
}
}
]
},
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 1
},
"raw": {
"posts": []
},
"request_id": "req_example123",
"credits_used": 1,
"credits_remaining": 99
}