Unified schema
One Post shape, one Author shape, one Comment shape, the same across every SocialCrawl platform. Field-level guarantees, per-platform availability, and machine-readable JSON Schema.
Unified schema
Most social-data APIs hand you raw upstream JSON, shaped differently on every platform. SocialCrawl normalizes each response into one canonical shape per archetype. A TikTok post and a YouTube video come back as the same Post; a Twitter profile and an Instagram profile come back as the same Author. Parse it once, read every platform.
Each page below documents a canonical shape: every field, its type, whether it can be null, which platforms populate it, and a machine-readable JSON Schema you can validate against.
Archetypes
- Post: the unified post shape.
- Author: the unified author or creator profile shape.
- Comment: the unified comment shape.
- Product: the unified product shape.
- Review: the unified review shape.
- Seller: the unified seller offer shape.
- Place: the unified place or business shape.
- App: the unified app-store listing shape.
- Quote: the unified financial quote shape.
- Job: the unified job posting shape.
- News article: the unified news article shape.
- Web page: the unified web page shape.
Cross-platform reference
- Field equivalence: how each platform's raw metric names map to the unified fields (e.g. TikTok
play_count= YouTubeviewCount=engagement.views).
Machine-readable schemas
Every archetype ships a JSON Schema (2020-12) at a stable URL, e.g. /schemas/post.json. Validate responses in code, or hand the URL to an agent so it can parse correctly on the first try.
Schema Compatibility Promise
How SocialCrawl classifies safe additions, value corrections, format corrections, and breaking schema changes for versioned unified response objects.
Post schema
The unified SocialCrawl post schema. Every field, its type, per-platform availability, and a machine-readable JSON Schema, generated from the canonical Zod source.