Skip to main content
POST
Scrape posts by URL

Authorizations

Authorization
string
header
required

Access token issued by gtm.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Body

application/json

Request body of scrape_linkedin_search_posts_by_url.

url
string
required

MUST start with https://www.linkedin.com/search/results/content/ (422 invalid_search_url otherwise).

Maximum string length: 2048
linkedin_account_sid
string | null

Preferred executor account (ln_ac_…). OPTIONAL everywhere on this surface: omitted → platform pool + credits (reason infra_pool); given with scraping-bucket budget → own account, charged 0; given but the bucket is saturated/held → automatic pool fallback (reason limit_fallback), never a 429 (§9.5).

Required string length: 18
Pattern: ^ln_ac_
idempotency_key
string | null

Ledger replay guard: a repeat call with the same (team, key) returns the stored outcome; no re-execution, no double charge. Recommended on every paid call.

Maximum string length: 128
page_size
integer | null

Rows per page (1..100); default 10.

Required range: 1 <= x <= 100
cursor
string | null

Opaque resume token from paging.next_cursor; null/omitted = first page.

Maximum string length: 2048

Response

action success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
action
action
string
required

kebab-case verb; matches the route segment.

item
any
required
result
object
required
meta
object
required
credits
object