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 = YouTube viewCount = 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.