Profiles

Look up a public profile

Read a public profile on Instagram, TikTok, YouTube, LinkedIn, X, Facebook or a website. A found answer includes the profile, recent posts and platform details when available: account ids, links, creation dates and public counts. Instagram's userId and graphId name different ids; neither grants permission. Missing fields are null; unsupported blocks are absent. Data outcomes answer 200: found, notFound (confirmed by the platform, cached an hour) or undecided (refunded, never cached). 1 credit on a miss, 0 on a hit. extractedAt is the original read time, including cache and snapshot hits.

post/profiles/lookup

Request

  • Base URL: https://api.socially.run/v1
  • URL: https://api.socially.run/v1/profiles/lookup
  • Auth: HTTP bearer

Request body

inputstring required

A profile URL, post URL, website or @handle.

platform'instagram' | 'linkedin' | 'youtube' | 'tiktok' | 'x' | 'facebook' | 'website'
postsinteger

Recent posts to return (0–15). Default 10. This limits the answer, not the source read.

refreshboolean

Bypass the cache and the snapshot; costs a credit even when fresh.

Response

Look up a public profile

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.