Search LinkedIn

Search public LinkedIn posts by keyword. Results are relevance-ranked.

GET /v1/linkedin/search

Keywords only

Supply the topic you care about (e.g. donald trump, AI safety). Plain keywords work best; boolean operators are not supported.

Query parameters

Parameter	Type	Default	Description
query	string	—	Required. Keyword(s), e.g. donald trump or AI safety.
max_pages	integer	1	Number of pages to fetch. Each page returns up to ~20 posts. Maximum 50.

Pages are deduplicated across the result set, and fewer pages come back if there are no further results.

Examples

Basic keyword search:

curl -G "$LISTENX_BASE/v1/linkedin/search" \
  -H "X-API-Key: $LISTENX_KEY" \
  --data-urlencode 'query=donald trump'

Three pages for a broader pull:

curl -G "$LISTENX_BASE/v1/linkedin/search" \
  -H "X-API-Key: $LISTENX_KEY" \
  --data-urlencode 'query=AI safety' \
  --data-urlencode 'max_pages=3'

Response

{
  "query": "donald trump",
  "pages_requested": 1,
  "pages_fetched": 1,
  "returned": 10,
  "results": [
    {
      "activity_id": "7510798120054652928",
      "url": "https://www.linkedin.com/posts/meritalk_president-donald-trump-unveiled-a-new-ai-activity-7510798120054652928-3RFt",
      "title": "MeriTalk's Post",
      "snippet": "President Donald Trump unveiled a new AI platform designed to give Americans a single digital point of entry for accessing federal …",
      "author_slug": "meritalk",
      "display_url": "https://www.linkedin.com/posts/meritalk_president-donald-trump-unveiled-a-new-ai-activity-7510798120054652928-3RFt",
      "thumbnail_url": "https://…"
    }
  ],
  "billing": {
    "endpoint": "linkedin.search",
    "units": 1,
    "unit_price": "0.010000",
    "amount": "0.010000",
    "balance_after": "97.240000",
    "request_id": "…"
  }
}

Fields

Field	Description
pages_requested	The max_pages you asked for.
pages_fetched	Pages actually fetched (also the number of billed units).
returned	Number of posts in results (deduplicated across pages).
results[]	Post summaries, in relevance order.

Result

Field	Description
activity_id	Numeric post id — pass to the post endpoint.
url	Canonical post URL.
title	Post title as it appears in search.
snippet	Short text excerpt of the post.
author_slug	Author handle.
thumbnail_url	Preview image, when available.

Billing

Search is billed per page fetched — units = pages_fetched, minimum 1. So max_pages=3 costs up to 3 units (fewer if there are no more results). See Billing.

Notes

• To pull the full post — author, body, engagement, and comments — call the post endpoint with a result's activity_id or url.
• Search is a discovery surface; results are not exhaustive and can shift over time.