Skip to main content
POST
Retrieve one synchronous page of comments written by a LinkedIn profile, with each comment’s text, date, like and reply counts, and the post it was left on. Rows are returned as found on LinkedIn, without profile enrichment.
Each successful request costs 1 credit, whatever the number of comments returned. A successful empty page is also 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.

Request fields

Send profile_url as a LinkedIn profile URL (linkedin.com/in/...). Optionally set posted_within to 24h, week, or month to return only recent comments. Unknown fields are rejected with 400.

Rate limit

The limit is 180 requests per minute per workspace for Profile comments, including requests made with different API keys for the same workspace. Post search and Comment likers 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

A page holds up to about 100 comments. Omit cursor on the first request. When pagination.next_cursor is not null, send it unchanged together with the same profile_url and posted_within to fetch the next page. A cursor sent with different fields, or to another endpoint, returns 400. pagination.total is always null for this endpoint because no reliable total is reported. Use has_more and next_cursor to decide whether to continue.

Retries

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

Next step

Send a returned comment_url to Comment likers to see who reacted to that comment.

Authorizations

Authorization
string
header
required

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

Body

application/json

A LinkedIn profile URL, an optional period, and an optional cursor. The JSON body must not exceed 16 KiB.

profile_url
string
required

LinkedIn profile URL (linkedin.com/in/...).

Required string length: 1 - 2048
posted_within
enum<string> | null

Only return comments from this period.

Available options:
24h,
week,
month,
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 comments written by the profile.

items
object[]
required

Comments written by the profile.

pagination
object
required
billing
object
required