Profile comments

curl --request POST \
  --url https://api.airscale.io/v1/profile-comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "profile_url": "https://www.linkedin.com/in/example-person"
}
'

{
  "items": [
    {
      "comment_url": "https://www.linkedin.com/posts/example-person_sales-activity-7511035039397339136-8myb?commentUrn=urn%3Ali%3Acomment%3A%28activity%3A7511035039397339136%2C7511040000000000000%29",
      "comment_id": "7511040000000000000",
      "comment": "Great point, thanks for sharing.",
      "commented_at": "2026-09-30T14:03:41.169Z",
      "likes": 12,
      "replies": 2,
      "post": {
        "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"
        }
      }
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJ2IjoxLCJyIjoiZXhhbXBsZSJ9",
    "total": null
  },
  "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

profile-comments

curl --request POST \
  --url https://api.airscale.io/v1/profile-comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "profile_url": "https://www.linkedin.com/in/example-person"
}
'

{
  "items": [
    {
      "comment_url": "https://www.linkedin.com/posts/example-person_sales-activity-7511035039397339136-8myb?commentUrn=urn%3Ali%3Acomment%3A%28activity%3A7511035039397339136%2C7511040000000000000%29",
      "comment_id": "7511040000000000000",
      "comment": "Great point, thanks for sharing.",
      "commented_at": "2026-09-30T14:03:41.169Z",
      "likes": 12,
      "replies": 2,
      "post": {
        "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"
        }
      }
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJ2IjoxLCJyIjoiZXhhbXBsZSJ9",
    "total": null
  },
  "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>"
}

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 non-empty request costs 1 credit, whatever the number of comments 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.

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, 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

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; 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

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.

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

Request fields

Rate limit

Retries

Next step

Authorizations

Body

Response