SocialScrape · Schema
SuccessEnvelope[ListPage[Annotated[Union[Song, Album, Profile, Collection], FieldInfo(annotation=NoneType, required=True, discriminator='object')]]]
Social MediaScraperDeveloper ToolsSocial ListeningCreator ResearchContent RepurposingAd Intelligence
Properties
| Name | Type | Description |
|---|---|---|
| ok | boolean | |
| credits_charged | integer | |
| credits_remaining | object | |
| cached | boolean | |
| cached_at | object | |
| request_id | string | |
| data | object | |
| cursor | object | |
| has_more | object | |
| raw | object |
JSON Schema
socialscrape-success-envelope-list-page-annotated-union-song-album-profile-collection-field-info-annotation-none-type-required-true-discriminator-object-schema.json
Raw ↑
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/socialscrape/json-schema/socialscrape-success-envelope-list-page-annotated-union-song-album-profile-collection-field-info-annotation-none-type-required-true-discriminator-object-schema.json",
"title": "SuccessEnvelope[ListPage[Annotated[Union[Song, Album, Profile, Collection], FieldInfo(annotation=NoneType, required=True, discriminator='object')]]]",
"x-generated": "2026-11-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/socialscrape-openapi.json#/components/schemas/SuccessEnvelope_ListPage_Annotated_Union_Song__Album__Profile__Collection___FieldInfo_annotation_NoneType__required_True__discriminator__object_____",
"properties": {
"ok": {
"const": true,
"default": true,
"title": "Ok",
"type": "boolean"
},
"credits_charged": {
"title": "Credits Charged",
"type": "integer"
},
"credits_remaining": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Credits Remaining"
},
"cached": {
"title": "Cached",
"type": "boolean"
},
"cached_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Cached At"
},
"request_id": {
"title": "Request Id",
"type": "string"
},
"data": {
"$ref": "#/$defs/ListPage_Annotated_Union_Song__Album__Profile__Collection___FieldInfo_annotation_NoneType__required_True__discriminator__object____"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"has_more": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Has More"
},
"raw": {
"default": null,
"title": "Raw"
}
},
"required": [
"credits_charged",
"credits_remaining",
"cached",
"cached_at",
"request_id",
"data"
],
"type": "object",
"$defs": {
"Advertiser": {
"additionalProperties": false,
"properties": {
"object": {
"const": "advertiser",
"default": "advertiser",
"title": "Object",
"type": "string"
},
"platform": {
"$ref": "#/$defs/Platform"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"page_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Page Id"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"ad_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Ad Count"
},
"extra": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Extra"
}
},
"required": [
"platform"
],
"title": "Advertiser",
"type": "object"
},
"Album": {
"additionalProperties": false,
"properties": {
"object": {
"const": "album",
"default": "album",
"title": "Object",
"type": "string"
},
"platform": {
"$ref": "#/$defs/Platform"
},
"id": {
"title": "Id",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"artists": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Artists"
},
"released_at": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Released At"
},
"track_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Track Count"
},
"cover_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cover Url"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Label"
},
"tracks": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/Song"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Tracks"
},
"extra": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Extra"
}
},
"required": [
"platform",
"id"
],
"title": "Album",
"type": "object"
},
"Author": {
"additionalProperties": false,
"description": "Compact reference to a profile, embedded in posts, comments, ads.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
}
},
"title": "Author",
"type": "object"
},
"Collection": {
"additionalProperties": false,
"description": "An ordered set of items someone curates: playlists, boards, podcasts, highlights.",
"properties": {
"object": {
"const": "collection",
"default": "collection",
"title": "Object",
"type": "string"
},
"platform": {
"$ref": "#/$defs/Platform"
},
"id": {
"title": "Id",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"kind": {
"default": "unknown",
"enum": [
"playlist",
"board",
"podcast",
"highlight",
"topic",
"collection",
"unknown"
],
"title": "Kind",
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"owner": {
"anyOf": [
{
"$ref": "#/$defs/Author"
},
{
"type": "null"
}
],
"default": null
},
"item_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Item Count"
},
"cover_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cover Url"
},
"updated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Updated At"
},
"extra": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Extra"
}
},
"required": [
"platform",
"id"
],
"title": "Collection",
"type": "object"
},
"Community": {
"additionalProperties": false,
"description": "A place people post into: subreddits, Facebook groups, X communities, Telegram channels.",
"properties": {
"object": {
"const": "community",
"default": "community",
"title": "Object",
"type": "string"
},
"platform": {
"$ref": "#/$defs/Platform"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"kind": {
"default": "unknown",
"enum": [
"subreddit",
"group",
"community",
"channel",
"unknown"
],
"title": "Kind",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"banner_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Banner Url"
},
"member_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Member Count"
},
"online_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Online Count"
},
"is_nsfw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Nsfw"
},
"is_private": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Private"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"created_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"extra": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Extra"
}
},
"required": [
"platform"
],
"title": "Community",
"type": "object"
},
"Link": {
"additionalProperties": false,
"properties": {
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"url": {
"title": "Url",
"type": "string"
}
},
"required": [
"url"
],
"title": "Link",
"type": "object"
},
"ListPage_Annotated_Union_Song__Album__Profile__Collection___FieldInfo_annotation_NoneType__required_True__discriminator__object____": {
"additionalProperties": false,
"properties": {
"object": {
"const": "list",
"default": "list",
"title": "Object",
"type": "string"
},
"items": {
"items": {
"oneOf": [
{
"$ref": "#/$defs/Song"
},
{
"$ref": "#/$defs/Album"
},
{
"$ref": "#/$defs/Profile"
},
{
"$ref": "#/$defs/Collection"
}
]
},
"title": "Items",
"type": "array"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Cursor"
},
"has_more": {
"default": false,
"title": "Has More",
"type": "boolean"
},
"parent": {
"anyOf": [
{
"oneOf": [
{
"$ref": "#/$defs/Profile"
},
{
"$ref": "#/$defs/Post"
},
{
"$ref": "#/$defs/Collection"
},
{
"$ref": "#/$defs/Community"
},
{
"$ref": "#/$defs/Song"
},
{
"$ref": "#/$defs/Album"
},
{
"$ref": "#/$defs/Advertiser"
}
]
},
{
"type": "null"
}
],
"default": null,
"title": "Parent"
}
},
"required": [
"items"
],
"title": "ListPage[Annotated[Union[Song, Album, Profile, Collection], FieldInfo(annotation=NoneType, required=True, discriminator='object')]]",
"type": "object"
},
"Media": {
"additionalProperties": false,
"properties": {
"thumbnail_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Thumbnail Url"
},
"video_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Video Url"
},
"audio_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Audio Url"
},
"image_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Urls"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Width"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Height"
}
},
"title": "Media",
"type": "object"
},
"Place": {
"additionalProperties": false,
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Address"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "City"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Region"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Latitude"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Longitude"
}
},
"title": "Place",
"type": "object"
},
"Platform": {
"enum": [
"youtube",
"tiktok",
"instagram",
"reddit",
"bluesky",
"threads",
"truthsocial",
"pinterest",
"twitch",
"kick",
"snapchat",
"linktree",
"komi",
"pillar",
"linkbio",
"linkme",
"twitter",
"facebook",
"linkedin",
"amazon",
"spotify",
"apple_music",
"soundcloud",
"github",
"kwai",
"rumble",
"telegram",
"google",
"cosmos",
"web"
],
"title": "Platform",
"type": "string"
},
"Post": {
"additionalProperties": false,
"description": "Videos, reels, tweets, pins, clips, stories, Reddit posts: all posts with a `type`.",
"properties": {
"object": {
"const": "post",
"default": "post",
"title": "Object",
"type": "string"
},
"platform": {
"$ref": "#/$defs/Platform"
},
"id": {
"title": "Id",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"type": {
"default": "unknown",
"enum": [
"video",
"short",
"reel",
"image",
"carousel",
"story",
"live",
"clip",
"text",
"link",
"tweet",
"pin",
"community_post",
"episode",
"unknown"
],
"title": "Type",
"type": "string"
},
"author": {
"anyOf": [
{
"$ref": "#/$defs/Author"
},
{
"type": "null"
}
],
"default": null
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Title"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Text"
},
"published_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Published At"
},
"duration_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Duration Seconds"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Language"
},
"hashtags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Hashtags"
},
"mentions": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentions"
},
"stats": {
"$ref": "#/$defs/Stats"
},
"media": {
"$ref": "#/$defs/Media"
},
"song": {
"anyOf": [
{
"$ref": "#/$defs/SongRef"
},
{
"type": "null"
}
],
"default": null
},
"location": {
"anyOf": [
{
"$ref": "#/$defs/Place"
},
{
"type": "null"
}
],
"default": null
},
"is_pinned": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Pinned"
},
"is_sponsored": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Sponsored"
},
"extra": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Extra"
}
},
"required": [
"platform",
"id"
],
"title": "Post",
"type": "object"
},
"Profile": {
"additionalProperties": false,
"properties": {
"object": {
"const": "profile",
"default": "profile",
"title": "Object",
"type": "string"
},
"platform": {
"$ref": "#/$defs/Platform"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"handle": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Handle"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"headline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Headline"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"kind": {
"default": "unknown",
"enum": [
"person",
"creator",
"channel",
"page",
"company",
"artist",
"organization",
"shop",
"unknown"
],
"title": "Kind",
"type": "string"
},
"bio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Bio"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Avatar Url"
},
"banner_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Banner Url"
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Verified"
},
"is_private": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Private"
},
"external_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "External Url"
},
"links": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/Link"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Links"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Location"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"created_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"stats": {
"$ref": "#/$defs/ProfileStats"
},
"extra": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Extra"
}
},
"required": [
"platform"
],
"title": "Profile",
"type": "object"
},
"ProfileStats": {
"additionalProperties": fa
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://artifacts.apis.io/socialscrape/json-schema/socialscrape-success-envelope-list-page-annotated-union-song-album-profile-collection-field-info-annotation-none-type-required-true-discriminator-object-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/socialscrape-success-envelope-list-page-annotated-union-song-album-profile-collection-field-info-annotation-none-type-required-true-discriminator-object"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.