Introduction

SocialListeningAPI searches public posts and web results from LinkedIn, X, Reddit, Facebook, Hacker News, TikTok, YouTube, Google, and Discourse forums. It also searches public Reddit comments, searches Instagram users, hashtags, and places, and fetches Instagram, LinkedIn, and X profiles, X threads and replies, comments from one Reddit post, and posts from one LinkedIn profile. Responses include normalized data by default. Set raw to true to include the original provider response.

Start in four steps

Create an account.
Open the activation email and confirm your address.
Copy your API key from the dashboard or Settings > API key.
Send your first request with the key in the x-api-key header.

Base URL

https://api.sociallisteningapi.com

GET and POST requests

Every API path accepts both GET and POST. Send parameters in the query string for GET, or as JSON with Content-Type: application/json for POST. The examples on each endpoint page use GET.

{
  "query": "social listening",
  "exact": true,
  "raw": true
}

Supported exact-search paths wrap the query in double quotes by default. Set exact to false to send the query unchanged.

Make your first request

curl --get 'https://api.sociallisteningapi.com/api/v1/linkedin/search' \
  --data-urlencode 'query=social listening' \
  --data-urlencode 'raw=true' \
  --header 'x-api-key: YOUR_API_KEY'

A successful response looks like this:

{
  "success": true,
  "platform": "linkedin",
  "endpoint": "/api/v1/linkedin/search",
  "data": {
    "items": [
      {
        "id": "linkedin_post_123",
        "platform": "linkedin",
        "url": "https://www.linkedin.com/posts/example",
        "content": {
          "title": null,
          "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": {
          "author_url": "https://www.linkedin.com/in/alex",
          "article_url": null
        }
      }
    ]
  },
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 1
  },
  "raw": {
    "elements": []
  },
  "request_id": "req_example123",
  "credits_used": 2,
  "credits_remaining": 98
}

Response rules

All responses use JSON. Successful responses include:

data: normalized output. Post, comment, and discovery collections use data.items; profile lookups return the profile directly in data.
pagination: the next cursor, whether more results are available, and the current page size.
raw: the unchanged provider response. This field is returned only when the request sets raw to true.
request_id: the ID to share when you need help with a request.
credits_used and credits_remaining: the cost and your balance after the request.

Errors use one shared shape:

{
  "success": false,
  "error": {
    "type": "INVALID_REQUEST",
    "message": "A required request parameter is missing or invalid",
    "status": 400
  },
  "request_id": "req_example123",
  "credits_used": 0,
  "credits_remaining": 100
}

Authentication, invalid parameters, rate limits, upstream failures, and other failed requests do not use credits. Facebook post search uses 7 credits. LinkedIn requests and Reddit comment search use 2 credits. Other successful paid requests use 1 credit.

Rate-limit details are returned in X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. A 429 response also includes Retry-After.

Endpoints

/openapi.json: Get the OpenAPI document
/api/v1/instagram/search: Search Instagram
/api/v1/instagram/profile: Get an Instagram profile
/api/v1/linkedin/search: Search LinkedIn posts
/api/v1/linkedin/profile: Get a LinkedIn profile
/api/v1/linkedin/profile/posts: Get LinkedIn profile posts
/api/v1/linkedin/user/posts: Get LinkedIn user posts
/api/v1/x/search: Search X posts
/api/v1/x/user: Get an X user
/api/v1/x/user/posts: Get X user posts
/api/v1/x/tweet/thread: Get an X tweet thread
/api/v1/x/tweet/replies: Get X tweet replies
/api/v1/reddit/search-posts: Search Reddit posts
/api/v1/reddit/search-comments: Search Reddit comments
/api/v1/reddit/post/comments: Get Reddit post comments
/api/v1/facebook/search: Search Facebook posts
/api/v1/hackernews/search: Search Hacker News posts
/api/v1/tiktok/search: Search TikTok posts
/api/v1/youtube/search: Search YouTube posts
/api/v1/google/search: Search Google
/api/v1/discourse/search: Search a Discourse forum