search

Search Posts Endpoint

Search LinkedIn posts with advanced filters

Authentification requise: Header api_key: <your_api_key>

Tarification: 1 credit per 10 posts returned

Search for LinkedIn posts using various filters like author company, industry, job title, content type, date, mentions, etc.

Available filters:

FilterDescriptionExample
keywordSearch in post content"AI startup"
author_companyAuthor's company name"Google"
author_industryAuthor's industry"Technology"
author_job_titleAuthor's job title"CEO"
content_typePost typeARTICLE, VIDEO, PHOTO, DOCUMENT
date_postedTime filterpast_24h, past_week, past_month
from_memberAuthor's member URN"ACoAABxxxxxx"
from_organizationCompany ID (numeric)"1234567"
mentions_memberMentioned member URN"ACoAABxxxxxx"
mentions_organizationMentioned org ID"1234567"
posted_byRelationship filterfirst, following, first,following
sort_bySort orderdate_posted (default), relevance

Example request:

{
    "keyword": "AI",
    "author_company": "Google",
    "content_type": "ARTICLE",
    "date_posted": "past_week",
    "sort_by": "date_posted",
    "count": 20
}

Example response:

{
    "total": 150,
    "offset": 0,
    "count": 20,
    "has_next": true,
    "credits_used": 2,
    "results": [
        {
            "urn": "urn:li:share:xxx",
            "url": "https://linkedin.com/feed/update/...",
            "content": "Post content here...",
            "likes": 150,
            "comments": 25,
            "shares": 10,
            "posted_date": "2024-01-15",
            "posted_days_ago": 3,
            "author": {
                "name": "John Doe",
                "headline": "CEO at Google",
                "profile_url": "https://linkedin.com/in/johndoe",
                "profile_picture": "https://..."
            },
            "images": []
        }
    ]
}
post/search/posts

Request

  • Base URL: https://api.dataforb2b.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.dataforb2b.ai/search/posts
  • Auth: none declared

Headers

api-keystring nullable

Request body

platformstring

Platform to search: linkedin, twitter, or reddit.

keywordstring nullable

Search keyword in post content

matchstring

Keyword matching: 'strict' (default) keeps only posts whose text actually contains the searched terms; 'loose' returns the platform's raw results.

post_urlstring nullable

Target a single post by URL (LinkedIn/Twitter/Reddit) instead of a keyword search. Use with include to get its engagers.

includestring[] nullable

Attach engagers to each returned post: any of ['reactions', 'comments']. Each engager is a lead. (Reddit exposes comments only — no upvoters.)

engagement_countinteger

Max engagers per type, per post, when include is set (1-1000).

subredditstring nullable

Reddit only: restrict the search to one subreddit (e.g. 'SaaS').

author_companystring nullable

Filter by author's company name

author_industrystring nullable

Filter by author's industry

author_job_titlestring nullable

Filter by author's job title

content_typestring nullable

Filter by content type: ARTICLE, VIDEO, PHOTO, DOCUMENT

date_postedstring nullable

Filter by date: past_24h, past_week, past_month

from_memberstring nullable

Filter by member URN (profile entity URN, e.g., ACoAABxxxxxx)

from_organizationstring nullable

Filter by organization/company ID (numeric)

mentions_memberstring nullable

Filter by mentioned member URN

mentions_organizationstring nullable

Filter by mentioned organization ID

posted_bystring nullable

Filter by relationship: first, following, first,following

sort_bystring

Sort order: date_posted or relevance

offsetinteger

Starting position for pagination

countinteger

Number of posts to return (max 100 per request)

force_tokenstring nullable

Force a specific token for testing (internal use only)

Response

Successful Response

totalinteger

Total number of posts matching the search

offsetinteger

Offset used for this request

countinteger

Number of posts returned

has_nextboolean

Whether there are more posts to fetch

credits_usednumber

Credits used for this request

resultsobject[]

List of posts

Changes

No recorded changes to this operation across all 1 revision of this API.