← Catalog

Social profile recent posts API: X, LinkedIn, Instagram, TikTok, YouTube as JSON

social.posts

live

Recent public posts for a social handle.

live coverage

Apify: X ✓Reddit ✓LinkedIn ✓Instagram ✓TikTok ✓YouTube ✓Facebook ✓

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

ProviderStatus
ScrapeCreators adapter next
Apify live
twitterapi.io planned
TikHub adapter next

Billing

Unit: per_result · unmatched results billed: no
Priced per result by platform: X $0.0007 a post, LinkedIn $0.0035, Reddit $0.00245 a post in search, $0.07 a run plus $0.00665 a post for a subreddit or user (inspect lists every platform). The hold covers the requested limit; the charge covers the results returned, so fewer results cost less, and failures and empty results release the hold. No date filter: filter on created_at after the call. If the provider's actual cost overruns the estimate, the run bills the overrun at the same per-call rate, capped by the hold.

The exact quote is returned by /v1/inspect before every call and held with headroom on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.jell.run/v1/run \
  -H "Authorization: Bearer $JELL_API_KEY" \
  -d '{
    "capability": "social.posts",
    "input": { "platform": "...", "handle": "..." },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "handle": {
      "description": "@handle, profile or page URL, LinkedIn company page (company/name), subreddit (r/name) or channel",
      "type": "string"
    },
    "limit": {
      "default": 5,
      "type": "integer"
    },
    "platform": {
      "enum": [
        "x",
        "reddit",
        "linkedin",
        "instagram",
        "tiktok",
        "youtube",
        "facebook",
        "douyin",
        "threads",
        "weibo",
        "xiaohongshu"
      ],
      "type": "string"
    }
  },
  "required": [
    "platform",
    "handle"
  ],
  "type": "object"
}

Normalized output fields

posts

Used in these guides

Turn competitor commenters on LinkedIn into a qualified lead list →Competitor ad intelligence →Social profile, post and comment data (X, Reddit, LinkedIn, TikTok, Instagram, YouTube) →