Post search

curl --request POST \
  --url https://api.airscale.io/v1/post-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keywords": "sales automation",
  "author_employer_company_urls": [
    "https://www.linkedin.com/company/example-company"
  ],
  "posted_within": "week"
}
'

{
  "items": [
    {
      "post_url": "https://www.linkedin.com/posts/example-person_sales-activity-7511035039397339136-8myb",
      "post_id": "7511035039397339136",
      "content": "Example post about sales automation.",
      "posted_at": "2026-09-30T12:11:41.675Z",
      "author": {
        "type": "person",
        "name": "Example Person",
        "linkedin_url": "https://www.linkedin.com/in/example-person",
        "headline": "Head of Sales at Example Company",
        "picture_url": "https://www.example.org/images/example-person.png"
      },
      "likes": 4,
      "comments": 1,
      "shares": 0,
      "feed_context": null,
      "image_urls": [
        "https://www.example.org/images/example-post.png"
      ],
      "content_type": "image",
      "media": null,
      "reposted_post": null
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJ2IjoxLCJyIjoiZXhhbXBsZSJ9",
    "total": 178
  },
  "billing": {
    "credits_consumed": 1
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

post-search

curl --request POST \
  --url https://api.airscale.io/v1/post-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keywords": "sales automation",
  "author_employer_company_urls": [
    "https://www.linkedin.com/company/example-company"
  ],
  "posted_within": "week"
}
'

{
  "items": [
    {
      "post_url": "https://www.linkedin.com/posts/example-person_sales-activity-7511035039397339136-8myb",
      "post_id": "7511035039397339136",
      "content": "Example post about sales automation.",
      "posted_at": "2026-09-30T12:11:41.675Z",
      "author": {
        "type": "person",
        "name": "Example Person",
        "linkedin_url": "https://www.linkedin.com/in/example-person",
        "headline": "Head of Sales at Example Company",
        "picture_url": "https://www.example.org/images/example-person.png"
      },
      "likes": 4,
      "comments": 1,
      "shares": 0,
      "feed_context": null,
      "image_urls": [
        "https://www.example.org/images/example-post.png"
      ],
      "content_type": "image",
      "media": null,
      "reposted_post": null
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJ2IjoxLCJyIjoiZXhhbXBsZSJ9",
    "total": 178
  },
  "billing": {
    "credits_consumed": 1
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Search LinkedIn posts and retrieve one synchronous page of up to 50 posts, each with its author, content, publication date, engagement counts, and image URLs. Rows are returned as found on LinkedIn, without profile enrichment.

Each successful non-empty request costs 1 credit, whatever the number of posts returned. A successful empty page is not charged. Invalid input and failed requests are not charged. The workspace needs at least 1 credit to start a request.

Authentication

Send your Airscale workspace API key as a Bearer token. Both V1 and V2 workspace API keys are accepted.

Filters

Provide keywords (up to 200 characters) or at least one author, mention, or group filter. All filters you send combine, so a post must match every one of them.

Field	Matches
`keywords`	Words in the post.
`author_keywords`	Words in the authors’ profiles (up to 200 characters).
`author_profile_urls`	Posts written by these profiles (`linkedin.com/in/...`).
`author_company_urls`	Posts published by these company pages (URL or numeric ID).
`author_employer_company_urls`	Posts whose authors work at these companies (URL or numeric ID).
`author_industry_ids`	Authors’ company industry, as numeric LinkedIn industry IDs.
`mentioning_profile_urls`	Posts that mention these profiles.
`mentioning_company_urls`	Posts that mention these companies (URL or numeric ID).
`group_url`	Posts inside one LinkedIn group (`linkedin.com/groups/...` or numeric ID).
`content_type`	`videos`, `images`, `live_videos`, `documents`, `collaborative_articles`, or `jobs`.
`sort_by`	`date` (default) or `relevance`.
`posted_within`	`24h`, `week`, or `month`, filtered by LinkedIn; or `1h`, `3months`, `6months`, or `year`, which require `sort_by: "date"`.

List filters accept a string or an array of up to 10 values. Unknown fields are rejected with 400. With posted_within set to 1h, 3months, 6months, or year, the period is applied to each fetched page, so a page can hold fewer than 50 posts. LinkedIn search can return fewer posts per author than that author’s full feed; use Profile posts or Company posts to read one author’s feed. Each post row includes feed_context, LinkedIn’s feed label when the row is not a plain post by the author, such as "Example Person reposted this" or "Example Company collaborated on this". It is null for a plain post. content_type names the kind of post: text, image, multi_image, video, document (a PDF carousel), poll, article (an article or link preview), or repost (a repost with the reposter’s own commentary). media holds the details: video_url and thumbnail_url for a video; title, page_count, cover_image_urls, and document_url for a document; question, options with votes, total_votes, and closed for a poll; url, title, subtitle, description, and thumbnail_url for an article. It is null for text, picture, and repost rows; pictures are in image_urls. For a repost row, reposted_post holds the shared post’s post_url, post_id, content_type, media, and image_urls. Media links are signed LinkedIn links that expire, so download them soon after the request.

Rate limit

The limit is 180 requests per minute per workspace for Post search, including requests made with different API keys for the same workspace. Profile comments, Comment likers, Profile posts, and Company posts each have their own separate 180-request allowance. Pagination requests and retries count toward the limit. The counter uses a fixed minute window and resets at the next minute boundary. Requests above the limit receive HTTP 429 and are not charged. When LinkedIn content capacity is busy for all workspaces, the response is a free 503 with Retry-After: 5.

Pagination

Omit cursor on the first request. When pagination.next_cursor is not null, send it unchanged together with the same filters to fetch the next page. A cursor sent with different filters, or to another endpoint, returns 400. pagination.total is the number of matching posts reported by LinkedIn, or null when unavailable.

Retries

This endpoint does not accept an idempotency key. Retrying a request fetches the page again; a non-empty page is charged again. Retry only responses that were not charged:

Response	Next action
`400 Bad Request`	Correct the body or cursor. The `message` field names the problem.
`403 Forbidden`	Add credits to the workspace before retrying.
`413 Payload Too Large`	Keep the JSON body under 16 KiB.
`429 Too Many Requests`	Wait for the next minute boundary, then retry with bounded exponential backoff.
`502 Bad Gateway` or `504 Gateway Timeout`	Retry with increasing delays and a fixed retry limit.
`503 Service Unavailable`	Wait for `Retry-After` when present, then retry with bounded backoff.

Next step

Use Profile comments to see what a post author comments on, or Post likers to retrieve enriched people who liked a post.

Authorizations

Authorization

string

header

required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json

Search filters and an optional cursor. The JSON body must not exceed 16 KiB.

Provide keywords or at least one author, mention, or group filter. All provided filters combine.

keywords

string | null

Words to search for in posts.

Maximum string length: 200

author_keywords

string | null

Words in the authors' profiles.

Maximum string length: 200

author_profile_urls

Posts written by these LinkedIn profiles (linkedin.com/in/...). A string or an array of up to 10 values.

Minimum string length: 1

author_company_urls

Posts published by these company pages, as LinkedIn company URLs or numeric company IDs. A string or an array of up to 10 values.

Minimum string length: 1

author_employer_company_urls

Posts whose authors work at these companies, as LinkedIn company URLs or numeric company IDs. A string or an array of up to 10 values.

Minimum string length: 1

author_industry_ids

Authors' company industry, as numeric LinkedIn industry IDs. A value or an array of up to 10 values.

mentioning_profile_urls

Posts that mention these LinkedIn profiles. A string or an array of up to 10 values.

Minimum string length: 1

mentioning_company_urls

Posts that mention these companies, as LinkedIn company URLs or numeric company IDs. A string or an array of up to 10 values.

Minimum string length: 1

group_url

Posts inside one LinkedIn group, as a group URL (linkedin.com/groups/...) or numeric group ID.

content_type

enum<string> | null

Available options:

videos,

images,

live_videos,

documents,

collaborative_articles,

jobs,

null

sort_by

enum<string> | null

default:date

Available options:

date,

relevance,

null

posted_within

enum<string> | null

24h, week, and month are filtered by LinkedIn. 1h, 3months, 6months, and year are applied to each fetched page, so pages can hold fewer than 50 posts; they require sort_by date.

Available options:

1h,

24h,

week,

month,

3months,

6months,

year,

null

cursor

string | null

The opaque pagination.next_cursor from the previous page. Send it unchanged with the same filters as the first page.

Required string length: 1 - 2048

Response

A page of LinkedIn posts.

items

object[]

required

Posts matching the filters.

Show child attributes

pagination

object

required

Show child attributes

billing

object

required

Show child attributes

Start here

Account

Search and discovery

Contact data

Profiles and reverse lookup

Post engagement

Intent signals

Miscellaneous

Table API

Authentication

Filters

Rate limit

Retries

Next step

Authorizations

Body

Response