Look up a public post
Read one public Instagram, TikTok, YouTube, X, LinkedIn or Facebook post by URL. Returns its caption, author id, date, media and public counts when available. X, LinkedIn and Facebook posts are read only through a paid reader, with exact counts, and a deployment with no reader configured answers 503 before it charges. A LinkedIn post's author.profileUrl is the person's or the company's own page, and a Facebook post's likes counts every reaction. A full Instagram read adds source ids and ordered frames with image/video URLs, dimensions, duration and alt text; missing fields are null. YouTube adds video/channel ids, title and description, not a playable stream. Every read says its detailLevel (detailed from the post's own page or API, embed from a thin public card that leaves what it does not show null) and its confidence; a cached answer keeps both. CDN URLs can expire: download the files. Answers found or undecided (refunded), never notFound. 1 credit on a miss, 0 on a hit. Cached answers keep the original extractedAt.
Request
- Base URL: https://api.socially.run/v1
- URL: https://api.socially.run/v1/posts/lookup
- Auth: HTTP bearer
Request body
Response
Look up a public post
Changes
No recorded changes to this operation across all 1 revision of this API.