Schemas

Profile

Public accounts (creators, channels, pages, companies, communities) with their bio, links, and follower and post counts.

Endpoints

36 endpoints return profiles on Amazon, Apple Music, Bluesky, Facebook, Facebook Ad Library, Google Ads Transparency Center, Instagram, Komi, Kwai, Lnk.Bio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube.

Schema

Single-item endpoints return this object as data; list endpoints return an array of them as data with a page object. The standard meta comes with every response.

platformstring

Platform ID (tiktok, youtube, …).

idstring

Platform-native account ID (string; YouTube UC…, Reddit t2_…).

usernamestringnullable

Handle without the @; null when the account has none.

display_namestringnullable

Display name, channel title or page name; null when empty or not exposed.

urlstring uri

Canonical profile URL.

typestring

Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown.

One ofpersonorganizationcommunityunknown

biostringnullable

Profile bio, channel description or page about text; null when empty or not exposed.

avatar_urlstring urinullable

Profile picture URL (largest available). Platform CDN URLs can expire within hours.

banner_urlstring urinullable

Header or cover image URL.

is_verifiedbooleannullable

Platform verification badge; null where the platform has no badge.

is_privatebooleannullable

True when the account's posts are not public.

categorystringnullable

Platform category label (e.g. Musician, Media & Entertainment), as shown; not normalized. Often set only for business or creator accounts.

external_linksobject[]

Links in the bio or channel links; [] if none or not exposed.

Show 2 child fields

urlstring uri

Link target, absolute (https:// is added where the platform stores the link without a scheme).

titlestringnullable

Link label shown by the platform.

locationstringnullable

Self-declared location text.

country_codestringnullable

ISO 3166-1 alpha-2 country the platform states for the account.

created_atstring date-timenullable

Account creation or join date, RFC 3339 UTC (some platforms give only the day: see approximate_fields).

metricsobject

Counts at fetch time; null = hidden or not exposed, 0 = zero.

Show 5 child fields

follower_countintegernullable

Followers or subscribers.

following_countintegernullable

Accounts this profile follows.

post_countintegernullable

Posts or videos as the platform counts them on the profile (for a private account, posts the caller cannot see).

total_like_countintegernullable

Likes received across all of the profile's posts (not likes given).

total_view_countintegernullable

Lifetime views across all of the profile's posts.

platform_specificobject

Fields only this platform has, under its ID (platform_specific.<platform>); each null when unknown.

Show 26 child fields

These fields, in this page's Markdown

approximate_fieldsstring[]

JSON paths of values rounded by the platform or parsed from display text (e.g. metrics.follower_count). A list path (external_links) means the list may be incomplete. [] when all exact.

unknown_fieldsstring[]

JSON paths of lists whose [] means unknown rather than none (a source that cannot see them); null already means unknown for every other field. [] when every list is known.

Item errors

Besides the request-level errors every endpoint can return, profile endpoints return:

Code	HTTP	Retry	Meaning	What to do
`not_found`	404	No	The item does not exist or was deleted. On GET /v1/requests/{id}/response: the response was not kept (details.reason says why).	Check the link or ID. Do not retry.
`private_or_unavailable`	403	No	The item exists but is not public: it is private, age- or region-restricted, or needs a login to view. It shares 403 with forbidden (which is about the key), so branch on the code.	Only public items can be fetched. Do not retry.

Example (Amazon)

{
  "data": {
    "approximate_fields": [
      "platform_specific.amazon.seller_feedback.positive_percent",
      "platform_specific.amazon.seller_feedback.last_30_days.rating",
      "platform_specific.amazon.seller_feedback.last_90_days.rating"
    ],
    "avatar_url": "https://m.media-amazon.com/images/I/31M25Gjck3L.jpg",
    "banner_url": null,
    "bio": "Due to Datavision's longstanding relationships with all major manufacturers we are able to offer a broader selection of products than even the largest online retailer.\n\nDatavision is also an Authorized Retailer for all major manufacturers including Apple, Sony, SONOS, Dyson, Sams…",
    "category": null,
    "country_code": "US",
    "created_at": null,
    "display_name": "DataVision Computer Video",
    "external_links": [],
    "id": "AN8LN2YPKS7DF",
    "is_private": false,
    "is_verified": null,
    "location": "55 W 39th Street, NEW YORK, NY, 10018, US",
    "metrics": {
      "follower_count": null,
      "following_count": null,
      "post_count": null,
      "total_like_count": null,
      "total_view_count": null
    },
    "platform": "amazon",
    "platform_specific": {
      "amazon": {
        "seller_business": {
          "address": "55 W 39th Street, NEW YORK, NY, 10018, US",
          "business_type": null,
          "customer_service_address": null,
          "customer_service_phone": "888-888-2087",
          "email": null,
          "legal_name": "DataVision Computer Video, Inc.",
          "phone": null,
          "trade_register_number": null,
          "vat_number": null
        },
        "seller_feedback": {
          "last_12_months": {
            "rating": 4.1,
            "rating_count": 178,
            "rating_distribution": {
              "five_star_count": 128,
              "four_star_count": 9,
              "one_star_count": 36,
              "three_star_count": 2,
              "two_star_count": 3
            },
            "review_count": 178
          },
          "last_30_days": {
            "rating": 2.7,
            "rating_count": 12,
            "rating_distribution": {
              "five_star_count": 5,
              "four_star_count": 0,
              "one_star_count": 7,
              "three_star_count": 0,
              "two_star_count": 0
            },
            "review_count": 12
          },
          "last_90_days": {
            "rating": 3.7,
            "rating_count": 36,
            "rating_distribution": {
              "five_star_count": 22,
              "four_star_count": 3,
              "one_star_count": 11,
              "three_star_count": 0,
              "two_star_count": 0
            },
            "review_count": 36
          },
          "lifetime": {
            "rating": 4.7,
            "rating_count": 144093,
            "rating_distribution": {
              "five_star_count": 123370,
              "four_star_count": 11762,
              "one_star_count": 4515,
              "three_star_count": 2784,
              "two_star_count": 1662
            },
            "review_count": 144086
          },
          "positive_percent": 77
        },
        "shop": null
      }
    },
    "type": "unknown",
    "unknown_fields": [],
    "url": "https://www.amazon.com/sp?seller=AN8LN2YPKS7DF",
    "username": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "amazon",
    "source": "page",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 0,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": "AN8LN2YPKS7DF",
      "url": "https://www.amazon.com/sp?seller=AN8LN2YPKS7DF"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

Long arrays and strings are shortened for display.