Search

Authorizations

Authorization

string

header

required

Bearer token authentication. Pass your API key as Authorization: Bearer <your_api_key>.

Headers

x-api-version

enum<string>

required

API version to use for request routing and response shape.

Available options:

2025-11-01

Body

application/json

Search keyword and optional filters, pagination, and sorting options.

Request payload for /dataset/social_post/search. A keyword is required; all other parameters are optional.

keyword

string

required

Keyword or phrase to search for in post content.

Example:

"artificial intelligence"

page

integer

default:1

Page number for pagination (1-based).

Example:

1

limit

integer

default:25

Number of posts to return per page (1–100).

Required range: 1 <= x <= 100

Example:

10

date_posted

enum<string>

Recency filter for posts.

Available options:

past-24h,

past-week,

past-month,

past-quarter,

past-year

Example:

"past-week"

content_type

enum<string>

Filter by post content type.

Available options:

all,

articles,

videos,

images,

text

Example:

"all"

sort_by

enum<string>

Result sort order — "relevance" (default) or "date_posted" (most recent first).

Available options:

relevance,

date_posted

Example:

"relevance"

exact_keyword_match

boolean

default:false

When true, only return posts containing the exact keyword phrase (no partial matches).

Example:

false

fields

string

Comma-separated list of response fields to include. Use to reduce payload size.

Example:

"text,total_reactions,date_posted,actor_name"

max_reactors

integer

default:0

Maximum number of reactor profiles to fetch per post. Requires "reactors" in the fields parameter.

Example:

0

max_comments

integer

default:0

Maximum number of comments to fetch per post. Requires "comments" in the fields parameter.

Example:

0

filters

object[] | null

Additional filter conditions to narrow search results by author attributes or mentions.

Show child attributes

Example:

[
  {
    "filter_type": "AUTHOR_INDUSTRY",
    "value": ["Technology, Information and Internet"]
  }
]

Response

object[] | null

Social posts matching the keyword and filters

backend_urn

string | null

Internal URN of the post on the professional network.

Example:

"urn:li:activity:7177658029017776128"

actor_backend_urn

string | null

Internal URN of the post author on the professional network.

Example:

"urn:li:member:123456789"

URN of the share object associated with this post.

Example:

"urn:li:share:7177658028019900416"

Public URL of the post on the professional network.

Example:

"https://www.linkedin.com/feed/update/urn:li:activity:7177658029017776128"

text

string | null

Full text content of the post.

Example:

"Excited to announce our latest product launch! We've been working on this for months and can't wait for you to try it."

hyperlinks

object

URLs extracted from the post text and attachments, categorized by type.

Show child attributes

Example:

{
  "company_professional_network_urls": ["https://www.linkedin.com/company/retool"],
  "person_professional_network_urls": null,
  "other_urls": ["https://retool.com/blog/launch"],
  "media_urls": null
}

actor_name

string | null

Display name of the post author (person or company).

Example:

"David Hsu"

actor_type

string | null

Type of author — "person" or "company". Present in search responses only.

Example:

"person"

date_posted

string | null

Date and time the post was published (format "YYYY-MM-DD HH:MM:SS").

Example:

"2025-03-15 14:30:00"

total_reactions

integer | null

Total number of reactions on the post across all reaction types.

Example:

342

total_comments

integer | null

Total number of comments on the post.

Example:

47

reactions_by_type

object

Reaction counts broken down by reaction type (LIKE, PRAISE, CURIOUS, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT).

Show child attributes

Example:

{
  "LIKE": 210,
  "PRAISE": 85,
  "CURIOUS": 12,
  "EMPATHY": 5,
  "INTEREST": 15,
  "APPRECIATION": 10,
  "ENTERTAINMENT": 5
}

num_shares

integer | null

Number of times the post was shared or reposted.

Example:

28

reactors

object[] | null

List of profiles who reacted to the post. Only populated when max_reactors > 0 in the request.

Example:

null

comments

object[] | null

List of comments on the post. Only populated when max_comments > 0 in the request.

Example:

null

is_repost_without_thoughts

boolean | null

True when the post is a repost with no added commentary from the reposter.

Example:

false

has_video

boolean | null

True when the post contains a video attachment.

Example:

false

company_details

object

Details about the company author. Present in search responses only when the author is a company.

Show child attributes

Example:

{
  "company_name": "TechStartup AI",
  "company_professional_network_id": "98765432",
  "company_professional_network_url": "https://www.linkedin.com/company/techstartup-ai",
  "company_domain": "techstartup.ai",
  "professional_network_industries": ["Technology, Information and Internet"],
  "professional_network_specialities": ["Artificial Intelligence"],
  "company_size": "11-50 employees",
  "crunchbase_categories": ["Artificial Intelligence"]
}

person_details

object

Details about the person author. Present in search responses only when the author is a person.

Show child attributes

Example:

{
  "person_name": "Jane Smith",
  "person_professional_network_urn": "urn:li:member:987654321",
  "person_professional_network_url": "https://www.linkedin.com/in/janesmith",
  "person_title": "Co-Founder & CEO",
  "person_location": "San Francisco, California",
  "current_employers": null
}

uid

string | null

Unique post identifier. Present in search responses only.

Example:

"urn:li:activity:7200123456789012345"

Example:

[
  {
    "backend_urn": "urn:li:activity:7200123456789012345",
    "actor_name": "Jane Smith",
    "text": "We just raised our Series A!",
    "total_reactions": 1250,
    "date_posted": "2025-03-20 10:15:00"
  }
]

API documentation

Company API

Person API

GitHub API

Glassdoor API

Social Post API

Web API

Authorizations

Headers

Body

Response