social_document.json
Formatted JSON Data
Schema Reference
root
document_id
stringreq
Internal unique identifier
platform_document_id
stringreq
Original platform post ID
source_platform
stringreq
e.g. "x", "reddit", "instagram"
published_at
datetimereq
Original publish timestamp (ISO 8601)
collected_at
datetimereq
Ingestion timestamp
collection_query
stringopt
Query that surfaced this document
tags
string[]arr
Free-form classification tags
raw_metadata
objectopt
Platform-specific overflow data
content_items[]
type
enumreq
"text" | "image" | "video" | "link"
value
stringopt
Text content (type=text only)
url
stringopt
Media or link URL
alt_text
stringopt
Image accessibility text
duration_seconds
integeropt
Video duration in seconds
language
stringopt
BCP-47 language code
author_metadata
author_id
stringreq
Internal author ID
username
stringreq
@handle or login
display_name
stringopt
Human-readable name
followers_count
integeropt
following_count
integeropt
post_count
integeropt
engagement_metrics
like_count
integeropt
reshare_count
integeropt
response_count
integeropt
entity_metadata
hashtags
string[]arr
mentions
string[]arr
urls
string[]arr