Author schema
The unified SocialCrawl author or creator profile schema. Every field, its type, per-platform availability, and a machine-readable JSON Schema, generated from the canonical Zod source.
Every SocialCrawl endpoint that returns a author or creator profile gives you this exact shape, whatever the source platform. Write your parser once and the same code reads author data from every platform below. That is the unified schema: one contract instead of a dozen raw upstream formats.
Field reference
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | No | Platform-specific user ID (always a string; platform-specific prefixes like did:, spotify:artist:, t2_ are stripped) |
username | string | Yes | User handle or username |
display_name | string | Yes | Display name or full name |
avatar_url | string | Yes | URL to profile picture |
bio | string | Yes | Profile biography or description |
verified | boolean | Yes | Whether the account is verified |
followers | number | Yes | Follower or subscriber count as an integer. Exact on Instagram and on TikTok when the source exposes an unrounded figure. YouTube above 1,000 subscribers is YouTube's published three-significant-figure figure. When the integer is a published/rounded value, author.ext.followers_approximate is true. |
following | number | Yes | Number of accounts followed |
posts_count | number | Yes | Total number of posts / videos / tracks / episodes |
likes_count | number | Yes | Total likes received across the author's content (when surfaced) |
url | string | Yes | Direct URL to the profile page |
location | string | Yes | ISO region code (e.g. US) or freeform location string when surfaced |
external_url | string | Yes | Bio link / external website URL when surfaced by the platform |
private | boolean | Yes | |
joined_at | string | Yes | |
last_post_at | string | Yes |
Extension fields (ext)
Platform-specific passthrough. Each field is present only on the platforms that expose it and is absent everywhere else, so treat every ext.* field as optional. These carry the richer, per-platform signals the unified leaves cannot hold, and the join keys that chain endpoints together.
| Field | Type | Nullable | Description |
|---|---|---|---|
ext.social_context | string | Yes | |
ext.account_created | string | Yes | |
ext.country | string | Yes | |
ext.country_name | string | Yes | |
ext.collects_received | number | Yes | |
ext.former_usernames | string[] | Yes | |
ext.former_usernames_count | integer | Yes | Instagram profile/about: how many former usernames Instagram's "About this account" panel lists for the account. 0 when the panel lists none, null when the panel could not be read on this call (the response then carries a note saying so). A count above 0 means the handle was renamed at least once; the names themselves are not published. |
ext.verified_at | string | Yes | Instagram profile/about, opt-in (include=verified_at): the month Instagram verified the account, as the panel shows it ("April 2024"). A month, not a date. Null when the account is not verified or the panel shows no verification date. Absent unless requested. |
ext.public_email | string | Yes | |
ext.contact_email | string | Yes | Opt-in (contact_email=1 on instagram/profile, youtube/channel and youtube/channel/about). When the bio lists two or more email addresses, the one the creator gives for contacting them personally, copied verbatim. Null when there is one address or none, when every address belongs to a manager, agency or brand, or when the choice was not confident. author.ext.public_email (the first address in the bio) is unchanged. |
ext.public_phone | string | Yes | |
ext.similar_source | string | Yes | |
ext.instagram_username | string | Yes | |
ext.similar_via | string | Yes | |
ext.business_category | string | Yes | |
ext.bio_links | object[] | Yes | |
ext.is_business | boolean | Yes | |
ext.is_professional | boolean | Yes | |
ext.creator_marketplace | boolean | Yes | |
ext.verification_label | string | Yes | |
ext.fbid | string | Yes | |
ext.hd_avatar_url | string | Yes | |
ext.website | string | Yes | |
ext.cover_url | string | Yes | |
ext.page_active | boolean | Yes | |
ext.employee_count | number | Yes | |
ext.employee_count_range.start | number | Yes | |
ext.employee_count_range.end | number | Yes | |
ext.founded_year | number | Yes | |
ext.company_type | string | Yes | |
ext.tagline | string | Yes | |
ext.specialities | string[] | Yes | |
ext.industries | string[] | Yes | |
ext.headquarters | object | Yes | |
ext.locations | any[] | Yes | |
ext.hashtags | any[] | Yes | |
ext.funding | object | Yes | |
ext.address | string | Yes | |
ext.price_range | string | Yes | |
ext.rating | string | Yes | |
ext.rating_count | number | Yes | |
ext.talking_about_count | number | Yes | |
ext.business_hours | any[] | Yes | |
ext.links | any[] | Yes | |
ext.ad_library_page_id | string | Yes | |
ext.ad_library_status | string | Yes | |
ext.urn | string | Yes | |
ext.is_top_voice | boolean | Yes | |
ext.is_premium | boolean | Yes | |
ext.is_creator | boolean | Yes | |
ext.is_influencer | boolean | Yes | |
ext.is_open_to_work | boolean | Yes | |
ext.is_hiring | boolean | Yes | |
ext.member_id | string | Yes | |
ext.company_id | string | Yes | |
ext.reaction_type | string | Yes | |
ext.followers_approximate | boolean | Yes | True when author.followers is a published or rounded figure rather than an unrounded census: LinkedIn people-list display buckets, TikTok stats.followerCount when the exact sibling is absent, and YouTube subscriber counts at or above 1,000. Null or absent on exact counts. |
ext.counts_source | string | Yes | TikTok profile only. Which of TikTok's two live counter sets author.followers, author.following, author.likes_count and author.posts_count carry: app (TikTok's app counters, the default) or web (the website's statsV2, returned with counts=web). The two sets can differ by a few percent in either direction. |
ext.keywords | string | Yes | |
ext.total_views | number | Yes | |
ext.joined_at_timestamp | string | Yes | |
ext.topicCategories | string[] | Yes | |
ext.bannerExternalUrl | string | Yes | |
ext.madeForKids | boolean | Yes | |
ext.hiddenSubscriberCount | boolean | Yes | |
ext.related_playlists | object | Yes | |
ext.topic_ids | string[] | Yes | |
ext.unsubscribed_trailer | string | Yes | |
ext.localizations | object | Yes | |
ext.monthly_listeners | number | Yes | |
ext.total_ratings | number | Yes | Spotify podcasts only: how many listeners have rated the show. Cumulative over the show's whole run, so it reflects longevity as well as size, and it is NOT an audience count (Spotify publishes no play, download, subscriber or follower count for a podcast) |
ext.average_rating | number | Yes | Spotify podcasts only: mean listener rating from 0 to 5. Fractional (e.g. 4.66) despite the integer type this schema emits for every numeric leaf |
ext.creator_username | string | Yes | |
ext.join_policy | string | Yes | |
ext.is_nsfw | boolean | Yes | |
ext.rules | object[] | Yes | |
ext.weekly_active_users | number | Yes | |
ext.weekly_contributions | number | Yes | |
ext.rules_text | string | Yes | |
ext.language | string | Yes | |
ext.post_karma | number | Yes | |
ext.comment_karma | number | Yes | |
ext.awardee_karma | number | Yes | |
ext.trophy_count | number | Yes | |
ext.banner_url | string | Yes | |
ext.profile_title | string | Yes | |
ext.social_links | any[] | Yes | |
ext.bio_link | string | Yes | |
ext.embed_html | string | Yes | |
ext.embed_url | string | Yes | |
ext.group | object | Yes | |
ext.search_hit.match | string | Yes | |
ext.search_hit.title | string | Yes | |
ext.search_hit.snippet | string | Yes | |
ext.search_hit.evidence_url | string | Yes | |
ext.search_hit.matched_urls | string[] | Yes | |
ext.blog_name | string | Yes | |
ext.blog_no | string | Yes | |
ext.visitors_today | number | Yes | |
ext.visitors_total | number | Yes | |
ext.topic | string | Yes | |
ext.power_blog | boolean | Yes | |
ext.official_blog | boolean | Yes |
Platform availability
31 platforms return the Author shape. id are never null on any platform. The fields below vary: yes means the platform populates it (the value may still be null); a blank means the platform never provides it, so it is always null.
| Platform | following | joined_at | posts_count | verified | private | likes_count | url | followers | bio | location | avatar_url | external_url |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Apple Music | yes | yes | ||||||||||
| Bluesky | yes | yes | yes | yes | yes | yes | ||||||
| Douyin | yes | yes | yes | yes | yes | yes | yes | yes | ||||
| yes | yes | yes | yes | yes | yes | yes | yes | yes | ||||
| G2 | yes | yes | yes | yes | ||||||||
| Gab | yes | yes | yes | yes | yes | yes | yes | yes | yes | |||
| GitHub | yes | yes | yes | yes | yes | yes | yes | yes | yes | yes | ||
| yes | ||||||||||||
| Hacker News | yes | yes | yes | |||||||||
| yes | yes | yes | yes | yes | yes | yes | yes | yes | ||||
| Komi | yes | yes | yes | |||||||||
| Kwai | yes | yes | yes | yes | yes | yes | yes | yes | yes | |||
| LinkBio | yes | |||||||||||
| yes | yes | yes | yes | yes | yes | yes | ||||||
| LinkMe | yes | yes | yes | yes | yes | |||||||
| Linktree | yes | yes | ||||||||||
| Naver | yes | yes | yes | yes | ||||||||
| Pillar | yes | yes | yes | yes | ||||||||
| Quora | yes | yes | yes | yes | ||||||||
| yes | yes | yes | yes | yes | yes | yes | yes | yes | yes | |||
| Snapchat | yes | yes | yes | yes | yes | yes | yes | yes | yes | |||
| Spotify | yes | yes | yes | |||||||||
| Telegram | yes | yes | yes | yes | yes | |||||||
| Threads | yes | yes | yes | yes | yes | yes | yes | yes | yes | yes | ||
| TikTok | yes | yes | yes | yes | yes | yes | yes | yes | yes | yes | ||
| Trustpilot | yes | yes | ||||||||||
| Truth Social | yes | yes | yes | yes | yes | yes | yes | yes | yes | yes | ||
| Twitch | yes | yes | yes | yes | yes | yes | yes | yes | yes | yes | ||
| Twitter/X | yes | yes | yes | yes | yes | yes | yes | yes | yes | |||
| Xiaohongshu | yes | yes | yes | yes | yes | yes | yes | yes | ||||
| YouTube | yes | yes | yes | yes | yes | yes | yes |
Machine-readable schema
Validate responses programmatically against the JSON Schema (2020-12):
Point a validator (Ajv, jsonschema, or your framework's) at that URL, or hand it to an agent so it can check the shape without a live call.
Returned by
Endpoints with the Author / AuthorList archetype return this shape:
Apple Music · Bluesky · Douyin · Facebook · G2 · Gab · GitHub · Google · Hacker News · Instagram · Komi · Kwai · LinkBio · LinkedIn · LinkMe · Linktree · Naver · Pillar · Quora · Reddit · Snapchat · Spotify · Telegram · Threads · TikTok · Trustpilot · Truth Social · Twitch · Twitter/X · Xiaohongshu · YouTube
See how the same fields map to each platform's raw upstream names in the cross-platform field equivalence table.