Search

Search posts

Searches LinkedIn posts using structured filters. To search from a pasted LinkedIn search URL instead, use POST .../search. Returns text, counts, author and attachments; the text can repeat fragments around links, mentions and hashtags, so get the post by its id for the clean body.

post/v1/{account_id}/search/posts

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/search/posts
  • Auth: HTTP bearer

Path parameters

account_idstring required

The linked LinkedIn account to search on behalf of.

Query parameters

offsetinteger

Zero-based pagination offset (default 0).

limitinteger

Maximum results per page (1-50, default 10).

cursorstring

Opaque pagination cursor returned from a previous response.

Request body

keywordsstring

Full-text keyword search in posts.

sort_by'relevance' | 'date'

Sort order: relevance (default) or date (newest first).

date_posted'past_day' | 'past_week' | 'past_month'

Filter by post recency.

content_type'videos' | 'images' | 'live_videos' | 'collaborative_articles' | 'documents'

Filter by content type (single value, not an array).

Response

A page of posts matching the filters. Each item carries post text, engagement counters, author details, and attachments when available.

object'post_search_result' required

Response type discriminator.

cursorstring nullable required

Opaque next-page cursor; null on the last page.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

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