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.
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.