API reference · LinkedIn

linkedin/bulk/post-search

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

APIAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDlinkedin/bulk/post-search

Input Schema

24 parameters · 0 required · 24 optional

Parameter	Type	Required	Description
`sortBy`	string	Optional	Sort by 'relevance' or 'date'. · Options: relevance, date relevancedate
`maxPosts`	integer	Optional	Maximum number of posts to scrape per each search query. If you set this to 0, it will scrape all posts. · Min: -9007199254740991 · Max: 9007199254740991
`startPage`	integer	Optional	The page number to start scraping from. · Min: 1 · Max: 100 · Default: 1
`authorUrls`	array	Optional	List of LinkedIn profile or company URLs to scrape. Example: `https://www.linkedin.com/in/williamhgates` will fetch posted or re-posted content by Bill Gates.
`contentType`	string	Optional	Filter posts by content type. For example, if you choose 'Videos', it will scrape only posts containing videos. · Options: all, videos, images, jobs, live_videos, documents, collaborative_articles allvideosimagesjobslive_videosdocumentscollaborative_articles
`maxComments`	integer	Optional	Maximum number of comments to scrape per post. Default is 10. · Min: -9007199254740991 · Max: 9007199254740991
`postedLimit`	string	Optional	Fetch posts no older than X time. Options: '1h', '24h', 'week', 'month'. · Options: any, 1h, 24h, week, month, 3months, 6months, year any1h24hweekmonth3months6monthsyear
`scrapePages`	integer	Optional	The number of search pages to scrape. Each page contains 100 posts · Min: 0 · Max: 100
`maxReactions`	integer	Optional	Maximum number of reactions to scrape per post. Default is 10. · Min: -9007199254740991 · Max: 9007199254740991
`searchQueries`	array	Optional	Queries to search LinkedIn posts. The same query as you would use in the LinkedIn search bar.
`authorKeywords`	string	Optional	Scrape posts of profile-authors whose profiles contain at least one of these keywords in the headline or job title sections.
`scrapeComments`	boolean	Optional	Scrape comments of posts.
`postedLimitDate`	string	Optional	Scrape posts from now up to and including this date. It supports the [Date time string format](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date#date_time_string_format). For example, "2011-10-10", or "2011-10-10T14:48:00.000+09:00" or a timestamp: "628021800000"
`scrapeReactions`	boolean	Optional	Scrape reactions of posts.
`authorsCompanies`	array	Optional	Scrape posts of profile-authors who assigned to LinkedIn Company Names of these companies. Example: `Google` will fetch posts of Google employees or ex-employees in some cases.
`mentioningMember`	array	Optional	List of LinkedIn profile URLs of members mentioned in posts. Example: `https://www.linkedin.com/in/williamhgates` will fetch posts mentioning Bill Gates.
`authorsIndustryId`	array	Optional	Scrape posts of profile-authors who assigned to LinkedIn Industry IDs of these industries. Full list: https://github.com/HarvestAPI/linkedin-industry-codes-v2/blob/main/linkedin_industry_code_v2_all_eng.csv
`mentioningCompany`	array	Optional	List of LinkedIn Company Names mentioned in posts. Example: `https://www.linkedin.com/company/google` will fetch posts mentioning Google.
`postNestedComments`	boolean	Optional	Whether to add comments items inside post items. In a case of hundreds of comments, the Actor might hit the max item size limit and won't be able to save a post.
`profileScraperMode`	string	Optional	Choose the mode for scraping LinkedIn profiles. The Short mode provides basic information, while the Full mode includes full detailed profile data. · Options: short, main · Default: "short" shortmain
`commentsPostedLimit`	string	Optional	Fetch comments no older than X time. Options: '1h', '24h', 'week', 'month'. · Options: any, 1h, 24h, week, month, 3months, 6months, year any1h24hweekmonth3months6monthsyear
`postNestedReactions`	boolean	Optional	Whether to add reactions items inside post items. In a case of hundreds of reactions, the Actor might hit the max item size limit and won't be able to save a post.
`commentsProfileScraperMode`	string	Optional	Choose the mode for scraping LinkedIn profiles. The Short mode provides basic information, while the Full mode includes full detailed profile data. · Options: short, main · Default: "short" shortmain
`reactionsProfileScraperMode`	string	Optional	Choose the mode for scraping LinkedIn profiles. The Short mode provides basic information, while the Full mode includes full detailed profile data. · Options: short, main · Default: "short" shortmain

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "linkedin/bulk/post-search",
  "startPage": 1,
  "profileScraperMode": "short",
  "commentsProfileScraperMode": "short",
  "reactionsProfileScraperMode": "short",
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to LinkedIn Post Search