Author

Any endpoint that returns a profile, creator, page or channel returns it in the profile shape below, whichever platform it came from. Posts and comments carry a smaller author object, a subset of the profile. One parser reads both from every platform. This page describes schema 2, which every key gets from October 4, 2026; what changed is on Schema 2.

Where profiles sit in data

A list of profiles also carries data.total (the platform's own total, not the size of this page) and data.truncated, both null when the platform does not say.

Author on a post or comment

For followers, bio and the rest, call the platform's profile endpoint with the username or id.

Profile

Example

/v1/instagram/profile?handle=nasa, shortened:

{
  "success": true,
  "platform": "instagram",
  "endpoint": "/v1/instagram/profile",
  "schema_version": "2",
  "data": {
    "author": {
      "id": "528817151",
      "username": "nasa",
      "display_name": "NASA",
      "avatar_url": "https://scontent-phl2-1.cdninstagram.com/v/…",
      "bio": "Making the seemingly impossible, possible. ✨",
      "verified": true,
      "followers": 104294818,
      "followers_approximate": null,
      "following": 90,
      "posts_count": 4942,
      "likes_count": null,
      "url": "https://www.instagram.com/nasa/",
      "location": null,
      "external_url": "https://www.nasa.gov",
      "private": false,
      "joined_at": null,
      "last_post_at": "2026-10-03T14:10:18.000Z",
      "ext": { "business_category": null }
    }
  },
  "unavailable": [],
  "credits_used": 10,
  "credits_remaining": 9990,
  "request_id": "req_d6ad52ab1f9f",
  "cached": false,
  "idempotent_replay": false,
  "charge_reason": "miss",
  "free_call": false
}

Fields

Every field is always present; a value the platform does not give is null.

A count is null when the platform does not show it and 0 only when it really is zero.

Extension fields (ext)

Platform-specific extras on the full profile. Each one appears only on platforms that provide it, so treat every ext field as optional. ext is null when a profile has no extras. Keys are snake_case on every platform, _id values are strings and _at values are ISO 8601 UTC times.

Which platforms fill which fields

Every platform that returns profiles uses this shape, and id is never null. The table covers the platforms the API launched with that return profiles. The others return the same shape, and each response's unavailable list names the fields it could not fill. yes means the platform can fill the field (it may still be null on a given row); a blank means it never does.

On Instagram, TikTok, Threads and Twitter/X, url is built from the handle when the platform sends none, and the link in the bio is always external_url. On a Reddit user, id is the t2_… account ID and display_name is null; a subreddit's id is its name.

unavailable

When a field the platform normally fills is null on every profile in a response, the response lists its path in unavailable, for example "author.followers" or "items[].author.joined_at". bio, external_url and location are never listed, because null there usually means the account has none. Fields a platform never shows publicly are never listed either:

For fields that are always null on a platform, see Metric substitutions.

Returned by

Endpoints that return a profile or a list of profiles use this shape on:

Facebook · Instagram · LinkedIn · Reddit · Threads · TikTok · Twitter/X · YouTube

To see which native platform field feeds each unified field, read Field equivalence.