OD. Media & Technology · Schema
substackNoteResponseSchema
Social MediaData APIDeveloper ToolsArtificial IntelligenceMarketing
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/scrapeatlas/main/json-schema/scrapeatlas-substack-note-response-schema-schema.json",
"title": "substackNoteResponseSchema",
"x-generated": "2026-10-19",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/scrapeatlas-openapi.json#/components/schemas/substackNoteResponseSchema",
"anyOf": [
{
"type": "object",
"properties": {
"requestId": {
"type": "string",
"format": "uuid"
},
"accounting": {
"type": "object",
"properties": {
"upstreamRequests": {
"type": "integer",
"minimum": 0
},
"responseBytes": {
"type": "integer",
"minimum": 0
},
"durationMs": {
"type": "number",
"minimum": 0
}
},
"required": [
"upstreamRequests",
"responseBytes",
"durationMs"
],
"additionalProperties": false
},
"success": {
"type": "boolean",
"const": true
},
"status": {
"type": "string",
"enum": [
"success",
"partial"
]
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"fetchedAt": {
"type": "string",
"format": "date-time"
},
"coverage": {
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "public_web"
},
"complete": {
"type": "boolean"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"order": {
"type": "string",
"enum": [
"source_order",
"ranked"
]
}
},
"required": [
"source",
"complete",
"warnings"
],
"additionalProperties": false
},
"item": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"post",
"comment"
]
},
"entity_key": {
"type": [
"string",
"null"
]
},
"post": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"publication_id": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"subtitle": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"audience": {
"type": [
"string",
"null"
]
},
"canonical_url": {
"type": [
"string",
"null"
]
},
"post_date": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"body_html": {
"type": [
"string",
"null"
]
},
"truncated_body_text": {
"type": [
"string",
"null"
]
},
"cover_image": {
"type": [
"string",
"null"
]
},
"wordcount": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"language": {
"type": [
"string",
"null"
]
},
"reaction_count": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"reactions": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "integer",
"minimum": 0
}
},
"restacks": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"comment_count": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"child_comment_count": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"podcast_url": {
"type": [
"string",
"null"
]
},
"podcast_duration": {
"type": [
"number",
"null"
],
"minimum": 0
},
"podcast_art_url": {
"type": [
"string",
"null"
]
},
"video_upload_id": {
"type": [
"string",
"null"
]
},
"podcast_upload_id": {
"type": [
"string",
"null"
]
},
"voiceover_upload_id": {
"type": [
"string",
"null"
]
},
"write_comment_permissions": {
"type": [
"string",
"null"
]
},
"section_id": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"section_name": {
"type": [
"string",
"null"
]
},
"section_slug": {
"type": [
"string",
"null"
]
},
"previous_post_slug": {
"type": [
"string",
"null"
]
},
"next_post_slug": {
"type": [
"string",
"null"
]
},
"is_geoblocked": {
"type": [
"boolean",
"null"
]
},
"is_published": {
"type": [
"boolean",
"null"
]
},
"publishedBylines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": [
"string",
"null"
]
},
"handle": {
"type": [
"string",
"null"
]
},
"photo_url": {
"type": [
"string",
"null"
]
},
"bio": {
"type": [
"string",
"null"
]
},
"twitter_screen_name": {
"type": [
"string",
"null"
]
},
"is_guest": {
"type": [
"boolean",
"null"
]
},
"bestseller_tier": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"name",
"handle",
"photo_url",
"bio",
"twitter_screen_name",
"is_guest",
"bestseller_tier"
],
"additionalProperties": false
},
"maxItems": 100
},
"postTags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"minimum": 0
}
]
},
{
"type": "null"
}
]
},
"name": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"slug"
],
"additionalProperties": false
},
"maxItems": 100
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"video",
"podcast",
"podcast_preview",
"voiceover",
"audio"
]
},
"url": {
"type": [
"string",
"null"
]
},
"duration": {
"type": [
"number",
"null"
],
"minimum": 0
},
"thumbnail": {
"type": [
"string",
"null"
]
},
"uploadId": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"media_type": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"uploaded_at": {
"type": [
"string",
"null"
]
},
"width": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"height": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"thumbnail_id": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"is_mux": {
"type": [
"boolean",
"null"
]
},
"mux_playback_id": {
"type": [
"string",
"null"
]
},
"mux_preview_playback_id": {
"type": [
"string",
"null"
]
},
"extractedAudioUploadId": {
"type": [
"string",
"null"
]
},
"transcription": {
"anyOf": [
{
"type": "object",
"properties": {
"transcript_url": {
"type": [
"string",
"null"
]
},
"cdn_url": {
"type": [
"string",
"null"
]
},
"cdn_unaligned_url": {
"type": [
"string",
"null"
]
},
"signed_captions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"language": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"original": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"language",
"url",
"original"
],
"additionalProperties": false
},
"maxItems": 100
}
},
"required": [
"transcript_url",
"cdn_url",
"cdn_unaligned_url",
"signed_captions"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"type",
"url",
"duration",
"thumbnail",
"uploadId",
"name",
"media_type",
"state",
"created_at",
"uploaded_at",
"width",
"height",
"thumbnail_id",
"is_mux",
"mux_playback_id",
"mux_preview_playback_id",
"extractedAudioUploadId",
"transcription"
],
"additionalProperties": false
},
"maxItems": 100
}
},
"required": [
"id",
"publication_id",
"slug",
"title",
"subtitle",
"type",
"audience",
"canonical_url",
"post_date",
"updated_at",
"description",
"body_html",
"truncated_body_text",
"cover_image",
"wordcount",
"language",
"reaction_count",
"reactions",
"restacks",
"comment_count",
"child_comment_count",
"podcast_url",
"podcast_duration",
"podcast_art_url",
"video_upload_id",
"podcast_upload_id",
"voiceover_upload_id",
"write_comment_permissions",
"section_id",
"section_name",
"section_slug",
"previous_post_slug",
"next_post_slug",
"is_geoblocked",
"is_published",
"publishedBylines",
"postTags",
"media"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"comment": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"body": {
"type": [
"string",
"null"
]
},
"body_json": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"publication_id": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"post_id": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"user_id": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"ancestor_path": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"deleted": {
"type": [
"boolean",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"edited_at": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"photo_url": {
"type": [
"string",
"null"
]
},
"handle": {
"type": [
"string",
"null"
]
},
"user_slug": {
"type": [
"string",
"null"
]
},
"reaction_count": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"reactions": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "integer",
"minimum": 0
}
},
"restacks": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"children_count": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"parentId": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"depth": {
"type": "integer",
"minimum": 0
},
"bio": {
"type": [
"string",
"null"
]
},
"language": {
"type": [
"string",
"null"
]
},
"user_bestseller_tier": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"user_primary_publication": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"subdomain": {
"type": "string"
},
"custom_domain": {
"type": [
"string",
"null"
]
},
"author_id": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 9007199254740991
},
"author_name": {
"type": [
"string",
"null"
]
},
"author_handle": {
"type": [
"string",
"null"
]
},
"author_photo_url": {
"type": [
"string",
"null"
]
},
"author_bio": {
"type": [
"string",
"null"
]
},
"twitter_screen_name": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"hero_text": {
"type": [
"string",
"null"
]
},
"logo_url": {
"type": [
"string",
"null"
]
},
"logo_url_wide": {
# --- truncated at 32 KB (223 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/scrapeatlas/refs/heads/main/json-schema/scrapeatlas-substack-note-response-schema-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/scrapeatlas-substack-note-response-schema"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.