# SocialDataKit API Public Instagram, TikTok and YouTube profiles, posts, videos and transcripts. Meta Ad Library company ads is a preview contract: live source validation is pending and live requests currently return 503 SOURCE_NOT_CONFIGURED without charging. companyName accepts only operator-verified Page ID mappings; use pageId for other advertisers. Docs: https://docs.socialdatakit.com Account and keys: https://app.socialdatakit.com/settings Interactive examples: https://docs.socialdatakit.com/#quickstart/interactive-example (local illustrative data; no API calls or credits) Status: https://socialdatakit.com/status OpenAPI: https://api.socialdatakit.com/openapi.json All six public Twitter/X routes return 501 SOURCE_NOT_IMPLEMENTED without charging. Four official API collectors are restricted to operator validation; a configured token does not activate public routes. Transcripts and community feeds have no collector. Selected versioned paths are request aliases, not response-format parity with other providers. Free balance: GET /v1/credit/balance with x-api-key; read data.credits_remaining. Hosted MCP: https://api.socialdatakit.com/mcp (Streamable HTTP, Authorization: Bearer SDK_API_KEY). Clients must support custom headers. Google Sheets, n8n and Make templates: https://socialdatakit.com/integrations. Bulk analysis: 5/25/100/200 profile URLs per batch on Air/Pro/Pro Max/Ultra. Paid campaigns: 1/5/20. Profile workflow: GET /v1/workflows/profile?url=PROFILE_URL. Campaign report: GET /v1/workflows/campaign-report?id=CAMPAIGN_ID, production key and paid access required. CLI and local stdio MCP: https://docs.socialdatakit.com/#integrations Tracking guide: https://docs.socialdatakit.com/#tracking. Campaign guide and report API reference: https://docs.socialdatakit.com/#campaigns. Tracking supports saved Instagram profiles/posts, TikTok profiles/videos and YouTube channels (preview)/videos. Air/Pro/Pro Max/Ultra allow 1/10/50/200 items, 1/1/5/20 lists and 7/30/90/365 days of history. Air checks are manual; paid tiers support daily checks and weekly dashboard reports. Each successful fresh check costs 1 credit; one attempt per item per 24 hours. Failed checks cost zero. Settings include a monthly usage cap (not a recurring payment), reset in UTC, and pause controls. No backfill or automatic discovery of new posts. Paid campaign limits are 1/5/20 active or paused campaigns; archived campaigns free a slot. Campaigns reuse tracking snapshots. Pausing, archiving or ending a campaign does not stop tracking checks; pause tracked items separately. Weekly reports cover Monday to Sunday in UTC. CSV and browser Print/Save PDF exports are free. Pro Max and Ultra support a custom printable report name. Reports use available observations within tier history limits, identify missing/rounded values and partial periods, and do not measure unique reach, sales or conversions. Campaign API uses id and optional report_id, with format=csv for CSV or default JSON {data,meta:{credits_charged:0}}. JSON timestamps are Unix milliseconds and period_end is exclusive. Dashboard sign-in manages tracking/campaigns; production API keys authenticate report reads. Base URL: https://api.socialdatakit.com Header: x-api-key: YOUR_API_KEY Production keys (sc_live_) return live public data or an error. Development keys (sc_test_) return free fixed samples. Air: 100 free starter credits. One-time packs: Pro USD 20 / 10,000 credits, Pro Max USD 40 / 25,000 credits, Ultra USD 100 / 75,000 credits. No monthly or annual subscriptions or automatic renewal. All credits are added after payment and never expire. The highest purchased tier retains its feature limits; smaller packs do not downgrade it. Buy another Pro, Pro Max or Ultra pack when you need more credits. Prices exclude applicable tax. Successful fresh results, including partial responses, use credits. Errors and cache hits are free. Limit: 60 requests per minute per account. By default, responses contain data and meta. TikTok profile also accepts format=compact to return only user (id, uniqueId, nickname, verified, region, language) and stats (followerCount, followingCount, heartCount, videoCount). Unknown values remain null. With compact output, request and credit details are in x-request-id, x-data-mode, x-cache, x-credits-charged and x-credits-remaining headers. Do not combine compact with fields or trim. Unavailable fields are null. Data may cover only items visible on the fetched page; do not assume complete history. Optional parameters: cache_max_age=1d|3d|7d|14d|30d; fields=comma-separated paths relative to data; trim=true removes empty values. Pagination: limit=1..20, default 3. Pass data.pagination.next_cursor unchanged as cursor until null. TikTok hashtag, sound and playlist buffered-page cursors expire after 10 minutes; restart without a cursor if expired. Cached responses can contain expired cursors. Rankings can change between source pages. ## Instagram profile Get a public profile’s bio, follower count, profile picture, links and verification status. GET /v1/instagram/profile Cost: 1 credits per successful fresh result. Identifier: exactly one of handle, url; primary example natgeo. curl 'https://api.socialdatakit.com/v1/instagram/profile?handle=natgeo' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Stable platform account ID when supplied; never an inferred username ID. - username (string | null): Current account handle. - display_name (string | null): Public display name. - bio (string | null): Public biography. - profile_url (string | null): Public profile URL. - followers (number | null): Observed audience count; page summaries may be rounded. - following (number | null): Observed following count. - posts (number | null): Observed content count. - verified (boolean | null): True or false only when explicitly returned; null means unknown. - private (boolean | null): Observed privacy state; null means unknown. - avatar_url (string | null): Source avatar URL, which can expire or restrict hotlinking. - avatar_variants (array | null): Returned avatar image variants. - avatar_variants[].url (string | null): Source URL. - avatar_variants[].width (number | null): Width in pixels. - avatar_variants[].height (number | null): Height in pixels. - avatar_variants[].asset_type (string | null): image, video, thumbnail or avatar. - avatar_variants[].variant (string | null): Source variant when known. - avatar_variants[].expires_at (string | null): Expiry timestamp when known. - external_url (string | null): Public external website. - account_type (string | null): Business/professional type only when explicitly observable. - category (string | null): Public profile category. - follower_count_is_rounded (boolean | null): True for abbreviated follower counts parsed from page summaries. - bio_links (array | null): Links published in the biography. - bio_links[].url (string | null): Destination URL. - bio_links[].title (string | null): Link title when returned. ## Instagram posts Get recent public posts, captions, images, videos, likes and comments when available. GET /v1/instagram/posts Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example natgeo. curl 'https://api.socialdatakit.com/v1/instagram/posts?handle=natgeo' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram post Get a public post or reel, its caption, media and available engagement counts. GET /v1/instagram/post Cost: 1 credits per successful fresh result. Identifier: exactly one of id, url; primary example CxDemo123. curl 'https://api.socialdatakit.com/v1/instagram/post?id=CxDemo123' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## TikTok profile Get a public profile’s bio, follower count, total likes, video count and profile picture. GET /v1/tiktok/profile Cost: 1 credits per successful fresh result. Identifier: exactly one of handle, url; primary example tiktok. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/profile?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Stable platform account ID when supplied; never an inferred username ID. - username (string | null): Current account handle. - display_name (string | null): Public display name. - bio (string | null): Public biography. - profile_url (string | null): Public profile URL. - followers (number | null): Observed audience count; page summaries may be rounded. - following (number | null): Observed following count. - posts (number | null): Observed content count. - verified (boolean | null): True or false only when explicitly returned; null means unknown. - private (boolean | null): Observed privacy state; null means unknown. - avatar_url (string | null): Source avatar URL, which can expire or restrict hotlinking. - avatar_variants (array | null): Returned avatar image variants. - avatar_variants[].url (string | null): Source URL. - avatar_variants[].width (number | null): Width in pixels. - avatar_variants[].height (number | null): Height in pixels. - avatar_variants[].asset_type (string | null): image, video, thumbnail or avatar. - avatar_variants[].variant (string | null): Source variant when known. - avatar_variants[].expires_at (string | null): Expiry timestamp when known. - external_url (string | null): Public external website. - likes (number | null): Total accumulated account likes. - region (string | null): Profile region only when explicitly supplied by TikTok; not inferred from the request location. - language (string | null): Profile language only when explicitly supplied by TikTok. ## TikTok videos Get videos from a public profile with captions, covers and available view counts. Some sources return only the latest ten videos. GET /v1/tiktok/videos Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/videos?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok video Get a public video’s caption, creator, cover and available metrics. Some videos return fewer details. GET /v1/tiktok/video Cost: 1 credits per successful fresh result. Identifier: exactly one of id; primary example 7350000000000000000. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/video?id=7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## YouTube video Get a video’s title, channel, description, duration, thumbnails and available view counts. GET /v1/youtube/video Cost: 1 credits per successful fresh result. Identifier: exactly one of id, url; primary example dQw4w9WgXcQ. curl 'https://api.socialdatakit.com/v1/youtube/video?id=dQw4w9WgXcQ' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## YouTube transcript Get available captions as plain text and timed sections, with language details. GET /v1/youtube/transcript Cost: 4 credits per successful fresh result. Identifier: exactly one of id; primary example dQw4w9WgXcQ. curl 'https://api.socialdatakit.com/v1/youtube/transcript?id=dQw4w9WgXcQ' \ -H 'x-api-key: YOUR_API_KEY' Fields: - video_id (string | null): YouTube video ID. - video_title (string | null): Public video title. - author (string | null): Channel display name. - channel_id (string | null): Owning channel ID. - language (string | null): Selected caption language; English is preferred when available. - language_name (string | null): Selected language display name. - generated (boolean | null): True for automatic speech-recognition captions. - available_languages (array | null): All caption tracks exposed by the player, not translated text. - available_languages[].language (string | null): Source language code. - available_languages[].language_name (string | null): Source language label. - available_languages[].generated (boolean | null): True for an automatic caption track. - available_languages[].translatable (boolean | null): Source translation capability. - text (string | null): Joined text of the selected caption track. - segment_count (number | null): Number of returned text segments. - duration_seconds (number | null): Last caption end time in seconds, not the video's duration; null if timing is incomplete. - segments (array | null): Caption segments in source order. - segments[].start (number | null): Start in seconds. - segments[].duration (number | null): Duration in seconds when supplied. - segments[].text (string | null): Caption text. ## YouTube channel (Preview: check status before use) Get a public channel’s name, description, subscriber count, videos, thumbnails and links. GET /v1/youtube/channel Cost: 1 credits per successful fresh result. Identifier: exactly one of handle, url, channelId, channel_id; primary example RickAstleyYT. curl 'https://api.socialdatakit.com/v1/youtube/channel?handle=RickAstleyYT' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Stable platform account ID when supplied; never an inferred username ID. - username (string | null): Current account handle. - display_name (string | null): Public display name. - bio (string | null): Public biography. - profile_url (string | null): Public profile URL. - followers (number | null): Observed audience count; page summaries may be rounded. - following (number | null): Observed following count. - posts (number | null): Observed content count. - verified (boolean | null): True or false only when explicitly returned; null means unknown. - private (boolean | null): Observed privacy state; null means unknown. - avatar_url (string | null): Source avatar URL, which can expire or restrict hotlinking. - avatar_variants (array | null): Returned avatar image variants. - avatar_variants[].url (string | null): Source URL. - avatar_variants[].width (number | null): Width in pixels. - avatar_variants[].height (number | null): Height in pixels. - avatar_variants[].asset_type (string | null): image, video, thumbnail or avatar. - avatar_variants[].variant (string | null): Source variant when known. - avatar_variants[].expires_at (string | null): Expiry timestamp when known. - external_url (string | null): Public external website. - created_at_platform (string | null): Channel creation timestamp. - country_code (string | null): Country set on the channel, not inferred location. - default_language (string | null): Source default language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - total_views (number | null): Public channel view count. - hidden_subscriber_count (boolean | null): Source subscriber-visibility flag. - subscriber_count_is_rounded (boolean | null): Public subscriber counts are rounded to three significant figures. - follower_count_is_rounded (boolean | null): Same precision marker for normalized followers. - uploads_playlist_id (string | null): Uploads playlist ID. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Source topic-category URLs. - keywords (string | null): Source channel keyword string. - unsubscribed_trailer (string | null): Public channel trailer video ID. ## YouTube channel videos (Preview: check status before use) Get videos uploaded by a public channel, with titles, thumbnails and available metrics. GET /v1/youtube/channel/videos Cost: 3 credits per successful fresh result. Identifier: exactly one of channel_id; primary example UCuAXFkgsw1L7xaCfnd5JJOw. curl 'https://api.socialdatakit.com/v1/youtube/channel/videos?channel_id=UCuAXFkgsw1L7xaCfnd5JJOw' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## YouTube channel playlists (Preview: check status before use) Public playlists owned by a channel, with descriptions, counts, thumbnails and languages. GET /v1/youtube/channel/playlists Cost: 1 credits per successful fresh result. Identifier: exactly one of channel_id; primary example UCuAXFkgsw1L7xaCfnd5JJOw. curl 'https://api.socialdatakit.com/v1/youtube/channel/playlists?channel_id=UCuAXFkgsw1L7xaCfnd5JJOw' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Playlist ID. - title (string | null): Playlist title. - description (string | null): Public description. - author (string | null): Public owner name/handle. - account_id (string | null): Playlist owner account ID. - item_count (number | null): Source total item count. - published_at (string | null): Creation timestamp. - updated_at (string | null): Source update time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - language (string | null): Default language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned localizations map. - privacy_status (string | null): Explicit source privacy status. - embed_html (string | null): Public embed markup as text. - permalink (string | null): Public playlist URL. ## YouTube playlist (Preview: check status before use) Get a public playlist’s title, description, owner, video count and thumbnails. GET /v1/youtube/playlist Cost: 1 credits per successful fresh result. Identifier: exactly one of playlist_id; primary example UUuAXFkgsw1L7xaCfnd5JJOw. curl 'https://api.socialdatakit.com/v1/youtube/playlist?playlist_id=UUuAXFkgsw1L7xaCfnd5JJOw' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Playlist ID. - title (string | null): Playlist title. - description (string | null): Public description. - author (string | null): Public owner name/handle. - account_id (string | null): Playlist owner account ID. - item_count (number | null): Source total item count. - published_at (string | null): Creation timestamp. - updated_at (string | null): Source update time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - language (string | null): Default language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned localizations map. - privacy_status (string | null): Explicit source privacy status. - embed_html (string | null): Public embed markup as text. - permalink (string | null): Public playlist URL. ## YouTube playlist items (Preview: check status before use) Get a public playlist’s videos in order, with IDs, titles and thumbnails. GET /v1/youtube/playlist/items Cost: 1 credits per successful fresh result. Identifier: exactly one of playlist_id; primary example UUuAXFkgsw1L7xaCfnd5JJOw. curl 'https://api.socialdatakit.com/v1/youtube/playlist/items?playlist_id=UUuAXFkgsw1L7xaCfnd5JJOw' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Playlist entry ID. Duplicate occurrences of a video have distinct entry IDs. - playlist_id (string | null): Parent playlist ID. - content_id (string | null): Video ID. - resource_kind (string | null): Source resource kind, normally youtube#video. - position (number | null): Zero-based source playlist position. - title (string | null): Entry title. - description (string | null): Entry description. - author (string | null): Video owner's channel name. - author_id (string | null): Video owner's channel ID. - playlist_owner_id (string | null): Playlist owner ID. - playlist_owner_name (string | null): Playlist owner name. - added_at (string | null): When the item was added to this playlist. - published_at (string | null): Video publication timestamp. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - privacy_status (string | null): Source privacy status. - permalink (string | null): Video URL. ## YouTube video comments (Preview: check status before use) Public top-level comments with author identity, text, likes, timestamps and reply counts. Use comment replies for the thread. GET /v1/youtube/comments Cost: 1 credits per successful fresh result. Identifier: exactly one of id; primary example dQw4w9WgXcQ. Optional: order, Comment order, example time. curl 'https://api.socialdatakit.com/v1/youtube/comments?id=dQw4w9WgXcQ' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. - image_url (string | null): Optional image/GIF attachment URL; null when absent. Signed URL expires six hours after retrieval. - image_url_retrieved_at (string | null): UTC timestamp when the attachment URL was retrieved; null without an attachment. - image_url_expires_at (string | null): UTC expiry of the signed attachment URL. Refresh the comment after expiry; historical archives do not refresh links. ## YouTube comment replies (Preview: check status before use) Public replies to a top-level comment; author details, text, likes, parent ID and timestamps. GET /v1/youtube/comment/replies Cost: 1 credits per successful fresh result. Identifier: exactly one of comment_id; primary example UgxExampleCommentId. curl 'https://api.socialdatakit.com/v1/youtube/comment/replies?comment_id=UgxExampleCommentId' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. - image_url (string | null): Optional image/GIF attachment URL; null when absent. Signed URL expires six hours after retrieval. - image_url_retrieved_at (string | null): UTC timestamp when the attachment URL was retrieved; null without an attachment. - image_url_expires_at (string | null): UTC expiry of the signed attachment URL. Refresh the comment after expiry; historical archives do not refresh links. ## YouTube search (Preview: check status before use) Public video, channel or playlist search results. Records query, returned order, region and language; not personalized website ranking. GET /v1/youtube/search Cost: 10 credits per successful fresh result. Identifier: exactly one of q, query; primary example creator tools. Optional: type, Result type, example video. Optional: order, Search order, example relevance. Optional: region_code, Region, example GB. Optional: language, Language, example en. curl 'https://api.socialdatakit.com/v1/youtube/search?q=creator+tools' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Matched platform object ID. - result_type (string | null): video, channel or playlist. - title (string | null): Source title. - description (string | null): Search snippet. - channel_id (string | null): Owning channel ID. - author (string | null): Channel name. - published_at (string | null): Source publish time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - live_status (string | null): Broadcast status. - permalink (string | null): Public result URL. - query (string | null): Query submitted. - position (number | null): One-based position in this API result traversal, not personalized website ranking. - region_code (string | null): Requested region, if specified. - language (string | null): Requested relevance language, if specified. - order (string | null): Requested sorting order. ## Instagram Reels (Unavailable: fresh live requests return 503 SOURCE_UNAVAILABLE; no credits charged) Get reels from a public profile, including captions, media and available metrics. GET /v1/instagram/reels Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example instagram. curl 'https://api.socialdatakit.com/v1/instagram/reels?handle=instagram' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram carousel items (Preview: check status before use) Get the images and videos in a public carousel post, in their original order. GET /v1/instagram/post/children Cost: 1 credits per successful fresh result. Identifier: exactly one of id; primary example CxDemo123. curl 'https://api.socialdatakit.com/v1/instagram/post/children?id=CxDemo123' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Carousel child media ID. - position (number | null): Zero-based carousel position. - media_type (string | null): image or video. - media_url (string | null): Preview image URL. - video_url (string | null): Source video URL when exposed. - width (number | null): Width in pixels. - height (number | null): Height in pixels. ## Instagram post comments (Unavailable: fresh live requests return 503 SOURCE_UNAVAILABLE; no credits charged) Get available public comments, author names, likes and reply counts. GET /v1/instagram/comments Cost: 2 credits per successful fresh result. Identifier: exactly one of id; primary example CxDemo123. curl 'https://api.socialdatakit.com/v1/instagram/comments?id=CxDemo123' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. ## Instagram hashtag (Unavailable: fresh live requests return 503 SOURCE_UNAVAILABLE; no credits charged) Get a public hashtag’s name and available post count. GET /v1/instagram/hashtag Cost: 1 credits per successful fresh result. Identifier: exactly one of tag, hashtag; primary example photography. curl 'https://api.socialdatakit.com/v1/instagram/hashtag?tag=photography' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Source hashtag ID. - name (string | null): Hashtag name. - description (string | null): Source description. - content_count (number | null): Observed number of related posts/videos. - views (number | null): Observed aggregate hashtag views, where exposed. - cover_url (string | null): Public cover URL. - permalink (string | null): Public hashtag page. ## Instagram hashtag posts (Unavailable: fresh live requests return 503 SOURCE_UNAVAILABLE; no credits charged) Get posts shown on a public hashtag page. Results may cover only part of the hashtag’s posts. GET /v1/instagram/hashtag/posts Cost: 2 credits per successful fresh result. Identifier: exactly one of tag; primary example photography. curl 'https://api.socialdatakit.com/v1/instagram/hashtag/posts?tag=photography' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## TikTok pinned videos (Unavailable: fresh live requests return 503 SOURCE_UNAVAILABLE; no credits charged) Get videos marked as pinned on a public profile. GET /v1/tiktok/pinned Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/pinned?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok sound (Preview: check status before use) Get a sound’s title, creator, duration, cover and available usage count. GET /v1/tiktok/music Cost: 1 credits per successful fresh result. Identifier: exactly one of id; primary example 6793970793613265670. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/music?id=6793970793613265670' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Sound ID. - title (string | null): Sound title. - author (string | null): Public sound author. - original (boolean | null): Explicit source original-sound flag. - duration_seconds (number | null): Sound duration. - cover_url (string | null): Cover URL. - play_url (string | null): Source preview URL; may expire. - content_count (number | null): Observed videos using the sound. - permalink (string | null): Public sound URL. ## TikTok sound videos (Preview: check status before use) Get public videos that use a specific sound. GET /v1/tiktok/music/videos Cost: 2 credits per successful fresh result. Identifier: exactly one of id; primary example 6793970793613265670. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/music/videos?id=6793970793613265670' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok hashtag (Preview: check status before use) Get a hashtag’s name, description, cover and available video and view counts. GET /v1/tiktok/hashtag Cost: 1 credits per successful fresh result. Identifier: exactly one of tag, hashtag; primary example photography. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/hashtag?tag=photography' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Source hashtag ID. - name (string | null): Hashtag name. - description (string | null): Source description. - content_count (number | null): Observed number of related posts/videos. - views (number | null): Observed aggregate hashtag views, where exposed. - cover_url (string | null): Public cover URL. - permalink (string | null): Public hashtag page. ## TikTok hashtag videos (Preview: check status before use) Get available public videos for a hashtag. GET /v1/tiktok/hashtag/videos Cost: 2 credits per successful fresh result. Identifier: exactly one of tag; primary example photography. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/hashtag/videos?tag=photography' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok playlist (Preview: check status before use) Get a public playlist’s title, creator, video count and last update time. GET /v1/tiktok/playlist Cost: 1 credits per successful fresh result. Identifier: exactly one of id; primary example 7350000000000000000. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/playlist?id=7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Playlist ID. - title (string | null): Playlist title. - description (string | null): Public description. - author (string | null): Public owner name/handle. - account_id (string | null): Playlist owner account ID. - item_count (number | null): Source total item count. - published_at (string | null): Creation timestamp. - updated_at (string | null): Source update time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - language (string | null): Default language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned localizations map. - privacy_status (string | null): Explicit source privacy status. - embed_html (string | null): Public embed markup as text. - permalink (string | null): Public playlist URL. ## TikTok playlist videos (Preview: check status before use) Get videos in a public TikTok playlist. GET /v1/tiktok/playlist/videos Cost: 2 credits per successful fresh result. Identifier: exactly one of id; primary example 7350000000000000000. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/playlist/videos?id=7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok video comments (Preview: check status before use) Get available public video comments, authors, likes and reply counts. GET /v1/tiktok/comments Cost: 2 credits per successful fresh result. Identifier: exactly one of id; primary example 7350000000000000000. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/comments?id=7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. ## TikTok comment replies (Preview: check status before use) Get available public replies to a comment. Include the video ID and comment ID. GET /v1/tiktok/comment/replies Cost: 2 credits per successful fresh result. Identifier: exactly one of comment_id; primary example 7350000000000000001. Required: video_id, TikTok video ID, example 7350000000000000000. Optional: region, Country code, example GB. curl 'https://api.socialdatakit.com/v1/tiktok/comment/replies?comment_id=7350000000000000001&video_id=7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. ## Instagram user posts (Preview: check status before use) Get a public profile's posts, including reels. GET /v2/instagram/user/posts Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example natgeo. curl 'https://api.socialdatakit.com/v2/instagram/user/posts?handle=natgeo' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram user reels (Unavailable: fresh live requests return 503 SOURCE_UNAVAILABLE; no credits charged) Get the public reels exposed by the source for a profile. GET /v1/instagram/user/reels Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example natgeo. curl 'https://api.socialdatakit.com/v1/instagram/user/reels?handle=natgeo' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram post comments (Unavailable: fresh live requests return 503 SOURCE_UNAVAILABLE; no credits charged) Get comments from a public post or reel. GET /v2/instagram/post/comments Cost: 2 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.instagram.com/p/CxDemo123/. curl 'https://api.socialdatakit.com/v2/instagram/post/comments?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FCxDemo123%2F' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. ## Instagram highlights (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a public profile's story highlight covers. GET /v1/instagram/user/highlights Cost: 1 credits per successful fresh result. Identifier: exactly one of handle; primary example natgeo. curl 'https://api.socialdatakit.com/v1/instagram/user/highlights?handle=natgeo' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram highlight detail (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get the items inside a public story highlight. GET /v1/instagram/user/highlight/detail Cost: 1 credits per successful fresh result. Identifier: exactly one of id; primary example 17912345678901234. curl 'https://api.socialdatakit.com/v1/instagram/user/highlight/detail?id=17912345678901234' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram media transcript (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a transcript for a public reel or video. GET /v2/instagram/media/transcript Cost: 4 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.instagram.com/reel/CxDemo123/. curl 'https://api.socialdatakit.com/v2/instagram/media/transcript?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FCxDemo123%2F' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram reel search (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Search public reels by keyword. GET /v2/instagram/reels/search Cost: 3 credits per successful fresh result. Identifier: exactly one of query; primary example travel. curl 'https://api.socialdatakit.com/v2/instagram/reels/search?query=travel' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Matched platform object ID. - result_type (string | null): video, channel or playlist. - title (string | null): Source title. - description (string | null): Search snippet. - channel_id (string | null): Owning channel ID. - author (string | null): Channel name. - published_at (string | null): Source publish time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - live_status (string | null): Broadcast status. - permalink (string | null): Public result URL. - query (string | null): Query submitted. - position (number | null): One-based position in this API result traversal, not personalized website ranking. - region_code (string | null): Requested region, if specified. - language (string | null): Requested relevance language, if specified. - order (string | null): Requested sorting order. ## Instagram profile by ID (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a public profile using its numeric account ID. GET /v1/instagram/basic/profile Cost: 1 credits per successful fresh result. Identifier: exactly one of userId; primary example 787132. curl 'https://api.socialdatakit.com/v1/instagram/basic/profile?userId=787132' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## Instagram embed HTML (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get the public embed markup for a profile. GET /v1/instagram/user/embed Cost: 1 credits per successful fresh result. Identifier: exactly one of handle; primary example natgeo. curl 'https://api.socialdatakit.com/v1/instagram/user/embed?handle=natgeo' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - platform_content_id (string | null): Platform media ID, separate from the shortcode. - caption (string | null): Public caption. - media_type (string | null): image, video, carousel, or null when unknown. - media_product_type (string | null): Source product type, kept separate from media type. - width (number | null): Media width in pixels. - height (number | null): Media height in pixels. - video_url (string | null): Source video URL where returned; may expire. - comments_enabled (boolean | null): Observed comments setting. - paid_partnership (boolean | null): Explicit source partnership flag; null when unavailable. - accessibility_caption (string | null): Source alt text or accessibility description. - location (object | null): Publicly attached location label. - location.id (string | null): Location ID. - location.name (string | null): Location name. - location.slug (string | null): Location slug. - tagged_users (array | null): Accounts explicitly tagged in the media. - tagged_users[].id (string | null): Platform account ID. - tagged_users[].username (string | null): Handle. - tagged_users[].display_name (string | null): Display name. - media_assets (array | null): Returned image/video variants with dimensions. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. - children (array | null): Ordered carousel children when returned; null for non-carousels. - children[].id (string | null): Media ID. - children[].position (number | null): Zero-based position. - children[].media_type (string | null): image, video or null. - children[].media_url (string | null): Preview image URL. - children[].video_url (string | null): Source video URL when available. - children[].width (number | null): Width in pixels. - children[].height (number | null): Height in pixels. ## TikTok profile videos (Preview: check status before use) Get videos from a public profile. GET /v3/tiktok/profile/videos Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. curl 'https://api.socialdatakit.com/v3/tiktok/profile/videos?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok video (Preview: check status before use) Get a public video's caption, creator, cover and metrics. GET /v2/tiktok/video Cost: 1 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.tiktok.com/@tiktok/video/7350000000000000000. curl 'https://api.socialdatakit.com/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok video comments (Preview: check status before use) Get public comments on a video. GET /v1/tiktok/video/comments Cost: 2 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.tiktok.com/@tiktok/video/7350000000000000000. curl 'https://api.socialdatakit.com/v1/tiktok/video/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. ## TikTok song (Preview: check status before use) Get a sound's title, creator, duration and usage count. GET /v1/tiktok/song Cost: 1 credits per successful fresh result. Identifier: exactly one of clipId, id; primary example 6793970793613265670. curl 'https://api.socialdatakit.com/v1/tiktok/song?clipId=6793970793613265670' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Sound ID. - title (string | null): Sound title. - author (string | null): Public sound author. - original (boolean | null): Explicit source original-sound flag. - duration_seconds (number | null): Sound duration. - cover_url (string | null): Cover URL. - play_url (string | null): Source preview URL; may expire. - content_count (number | null): Observed videos using the sound. - permalink (string | null): Public sound URL. ## TikTok song videos (Preview: check status before use) Get public videos that use a specific sound. GET /v1/tiktok/song/videos Cost: 2 credits per successful fresh result. Identifier: exactly one of clipId, id; primary example 6793970793613265670. curl 'https://api.socialdatakit.com/v1/tiktok/song/videos?clipId=6793970793613265670' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok video transcript (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a transcript for a public video. GET /v1/tiktok/video/transcript Cost: 4 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.tiktok.com/@tiktok/video/7350000000000000000. Optional: lang, Language, example en. curl 'https://api.socialdatakit.com/v1/tiktok/video/transcript?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7350000000000000000' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok user search (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Search public TikTok accounts by keyword. GET /v1/tiktok/search/users Cost: 3 credits per successful fresh result. Identifier: exactly one of query; primary example nasa. curl 'https://api.socialdatakit.com/v1/tiktok/search/users?query=nasa' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Matched platform object ID. - result_type (string | null): video, channel or playlist. - title (string | null): Source title. - description (string | null): Search snippet. - channel_id (string | null): Owning channel ID. - author (string | null): Channel name. - published_at (string | null): Source publish time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - live_status (string | null): Broadcast status. - permalink (string | null): Public result URL. - query (string | null): Query submitted. - position (number | null): One-based position in this API result traversal, not personalized website ranking. - region_code (string | null): Requested region, if specified. - language (string | null): Requested relevance language, if specified. - order (string | null): Requested sorting order. ## TikTok keyword search (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Search public videos by keyword. GET /v1/tiktok/search/keyword Cost: 3 credits per successful fresh result. Identifier: exactly one of query; primary example space. curl 'https://api.socialdatakit.com/v1/tiktok/search/keyword?query=space' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Matched platform object ID. - result_type (string | null): video, channel or playlist. - title (string | null): Source title. - description (string | null): Search snippet. - channel_id (string | null): Owning channel ID. - author (string | null): Channel name. - published_at (string | null): Source publish time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - live_status (string | null): Broadcast status. - permalink (string | null): Public result URL. - query (string | null): Query submitted. - position (number | null): One-based position in this API result traversal, not personalized website ranking. - region_code (string | null): Requested region, if specified. - language (string | null): Requested relevance language, if specified. - order (string | null): Requested sorting order. ## TikTok hashtag search (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Search public hashtags by keyword. GET /v1/tiktok/search/hashtag Cost: 3 credits per successful fresh result. Identifier: exactly one of hashtag; primary example photography. curl 'https://api.socialdatakit.com/v1/tiktok/search/hashtag?hashtag=photography' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Matched platform object ID. - result_type (string | null): video, channel or playlist. - title (string | null): Source title. - description (string | null): Search snippet. - channel_id (string | null): Owning channel ID. - author (string | null): Channel name. - published_at (string | null): Source publish time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - live_status (string | null): Broadcast status. - permalink (string | null): Public result URL. - query (string | null): Query submitted. - position (number | null): One-based position in this API result traversal, not personalized website ranking. - region_code (string | null): Requested region, if specified. - language (string | null): Requested relevance language, if specified. - order (string | null): Requested sorting order. ## TikTok top search (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get the blended top results for a keyword. GET /v1/tiktok/search/top Cost: 3 credits per successful fresh result. Identifier: exactly one of query; primary example space. curl 'https://api.socialdatakit.com/v1/tiktok/search/top?query=space' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Matched platform object ID. - result_type (string | null): video, channel or playlist. - title (string | null): Source title. - description (string | null): Search snippet. - channel_id (string | null): Owning channel ID. - author (string | null): Channel name. - published_at (string | null): Source publish time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - live_status (string | null): Broadcast status. - permalink (string | null): Public result URL. - query (string | null): Query submitted. - position (number | null): One-based position in this API result traversal, not personalized website ranking. - region_code (string | null): Requested region, if specified. - language (string | null): Requested relevance language, if specified. - order (string | null): Requested sorting order. ## TikTok following (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get accounts a public profile follows. GET /v1/tiktok/user/following Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. curl 'https://api.socialdatakit.com/v1/tiktok/user/following?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok followers (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get followers of a public profile. GET /v1/tiktok/user/followers Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. curl 'https://api.socialdatakit.com/v1/tiktok/user/followers?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok audience (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get published audience demographics for a creator. GET /v1/tiktok/user/audience Cost: 26 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. curl 'https://api.socialdatakit.com/v1/tiktok/user/audience?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok live (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a profile's live stream state. GET /v1/tiktok/user/live Cost: 1 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. curl 'https://api.socialdatakit.com/v1/tiktok/user/live?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok trending feed (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get the public trending feed for a region. GET /v1/tiktok/get-trending-feed Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example GB. curl 'https://api.socialdatakit.com/v1/tiktok/get-trending-feed?handle=GB' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok popular videos (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get popular public videos. GET /v1/tiktok/videos/popular Cost: 2 credits per successful fresh result. Identifier: exactly one of query; primary example GB. curl 'https://api.socialdatakit.com/v1/tiktok/videos/popular?query=GB' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok popular creators (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get popular creators, filterable by follower count and country. GET /v1/tiktok/creators/popular Cost: 2 credits per successful fresh result. Identifier: exactly one of query; primary example GB. curl 'https://api.socialdatakit.com/v1/tiktok/creators/popular?query=GB' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok popular hashtags (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get currently popular hashtags. GET /v1/tiktok/hashtags/popular Cost: 2 credits per successful fresh result. Identifier: exactly one of query; primary example GB. curl 'https://api.socialdatakit.com/v1/tiktok/hashtags/popular?query=GB' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Source hashtag ID. - name (string | null): Hashtag name. - description (string | null): Source description. - content_count (number | null): Observed number of related posts/videos. - views (number | null): Observed aggregate hashtag views, where exposed. - cover_url (string | null): Public cover URL. - permalink (string | null): Public hashtag page. ## TikTok popular songs (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get currently popular sounds. GET /v1/tiktok/songs/popular Cost: 2 credits per successful fresh result. Identifier: exactly one of query; primary example GB. curl 'https://api.socialdatakit.com/v1/tiktok/songs/popular?query=GB' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Sound ID. - title (string | null): Sound title. - author (string | null): Public sound author. - original (boolean | null): Explicit source original-sound flag. - duration_seconds (number | null): Sound duration. - cover_url (string | null): Cover URL. - play_url (string | null): Source preview URL; may expire. - content_count (number | null): Observed videos using the sound. - permalink (string | null): Public sound URL. ## TikTok Shop search (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Search public TikTok Shop products. GET /v1/tiktok/shop/search Cost: 2 credits per successful fresh result. Identifier: exactly one of query; primary example headphones. curl 'https://api.socialdatakit.com/v1/tiktok/shop/search?query=headphones' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok Shop store products (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get products listed by a public store. GET /v1/tiktok/shop/products Cost: 2 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.tiktok.com/shop/store/example. curl 'https://api.socialdatakit.com/v1/tiktok/shop/products?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fstore%2Fexample' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok product (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a public product's detail. GET /v1/tiktok/product Cost: 1 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.tiktok.com/shop/pdp/example. curl 'https://api.socialdatakit.com/v1/tiktok/product?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fexample' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## TikTok product reviews (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get public reviews for a product. GET /v1/tiktok/shop/product/reviews Cost: 2 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.tiktok.com/shop/pdp/example. curl 'https://api.socialdatakit.com/v1/tiktok/shop/product/reviews?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fexample' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. ## TikTok showcase (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get products showcased on a public profile. GET /v1/tiktok/user/showcase Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example tiktok. curl 'https://api.socialdatakit.com/v1/tiktok/user/showcase?handle=tiktok' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - caption (string | null): Public video description. - shares (number | null): Observed shares. - favorites (number | null): Observed collect count; null when absent. - width (number | null): Video width in pixels. - height (number | null): Video height in pixels. - author_id (string | null): Stable creator ID when returned. - author_display_name (string | null): Public display name. - author_verified (boolean | null): Explicit creator verification state. - author_avatar_url (string | null): Public creator avatar URL. - region_code (string | null): Source content region code when exposed; not proof of creator residence. - video_url (string | null): Public playback URL when supplied; may expire or require source request headers. - subtitle_tracks (array | null): Subtitle links exposed by the public video; does not run transcription. - subtitle_tracks[].language (string | null): Source language code. - subtitle_tracks[].language_id (string | null): Source language identifier. - subtitle_tracks[].url (string | null): Source subtitle URL. - subtitle_tracks[].format (string | null): Subtitle format. - effects (array | null): Effect metadata exposed by the public page. - effects[].id (string | null): Effect ID. - effects[].name (string | null): Effect name. - stickers (array | null): Sticker metadata exposed by the public page. - stickers[].type (number | null): Source sticker type. - stickers[].texts (array | null): Returned sticker text. - music (object | null): Sound metadata from the public video. - music.id (string | null): Sound ID. - music.title (string | null): Sound title. - music.author (string | null): Sound author. - music.original (boolean | null): Source original-sound flag. - music.duration_seconds (number | null): Sound duration. - music.cover_url (string | null): Sound cover URL. - music.play_url (string | null): Sound preview URL. - playlist_id (string | null): Source playlist ID when returned. - pinned (boolean | null): Explicit pinned-item state when returned. - media_assets (array | null): Returned cover variants. - media_assets[].url (string | null): Source URL. - media_assets[].width (number | null): Width in pixels. - media_assets[].height (number | null): Height in pixels. - media_assets[].asset_type (string | null): image, video, thumbnail or avatar. - media_assets[].variant (string | null): Source variant when known. - media_assets[].expires_at (string | null): Expiry timestamp when known. ## YouTube channel shorts (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get shorts uploaded by a public channel. GET /v1/youtube/channel/shorts Cost: 3 credits per successful fresh result. Identifier: exactly one of handle; primary example RickAstleyYT. curl 'https://api.socialdatakit.com/v1/youtube/channel/shorts?handle=RickAstleyYT' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## YouTube video transcript (Preview: check status before use) Get available captions as text and timed sections. GET /v1/youtube/video/transcript Cost: 4 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.youtube.com/watch?v=dQw4w9WgXcQ. curl 'https://api.socialdatakit.com/v1/youtube/video/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## YouTube video comments (Preview: check status before use) Get public top-level comments on a video. GET /v1/youtube/video/comments Cost: 2 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.youtube.com/watch?v=dQw4w9WgXcQ. curl 'https://api.socialdatakit.com/v1/youtube/video/comments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Platform comment ID, retained as a string. - content_id (string | null): Parent video/post ID when known. - parent_comment_id (string | null): Top-level comment ID for a reply; null for a top-level comment or unknown parent. - text (string | null): Public comment text. YouTube requests plainText formatting; no owner-only textOriginal. - likes (number | null): Observed comment likes. - reply_count (number | null): Observed total reply count; not the number of replies returned. - author_id (string | null): Public author account ID. - author_username (string | null): Public author handle. - author_display_name (string | null): Public display name. - author_avatar_url (string | null): Public avatar URL. - author_profile_url (string | null): Public author profile URL. - published_at (string | null): Comment publication timestamp. - updated_at (string | null): Source edit timestamp when available. - image_url (string | null): Optional image/GIF attachment URL; null when absent. Signed URL expires six hours after retrieval. - image_url_retrieved_at (string | null): UTC timestamp when the attachment URL was retrieved; null without an attachment. - image_url_expires_at (string | null): UTC expiry of the signed attachment URL. Refresh the comment after expiry; historical archives do not refresh links. ## YouTube community post (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a public community post. GET /v1/youtube/community-post Cost: 1 credits per successful fresh result. Identifier: exactly one of url; primary example https://www.youtube.com/post/UgkxDemo. curl 'https://api.socialdatakit.com/v1/youtube/community-post?url=https%3A%2F%2Fwww.youtube.com%2Fpost%2FUgkxDemo' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## YouTube hashtag search (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get public videos for a hashtag. GET /v1/youtube/search/hashtag Cost: 3 credits per successful fresh result. Identifier: exactly one of hashtag; primary example shorts. curl 'https://api.socialdatakit.com/v1/youtube/search/hashtag?hashtag=shorts' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Matched platform object ID. - result_type (string | null): video, channel or playlist. - title (string | null): Source title. - description (string | null): Search snippet. - channel_id (string | null): Owning channel ID. - author (string | null): Channel name. - published_at (string | null): Source publish time. - thumbnails (array | null): All returned thumbnail variants; dimensions are source values. - thumbnails[].url (string | null): Source URL. - thumbnails[].variant (string | null): Source variant. - thumbnails[].width (number | null): Width. - thumbnails[].height (number | null): Height. - thumbnails[].asset_type (string | null): thumbnail. - thumbnails[].expires_at (string | null): Expiry when known. - live_status (string | null): Broadcast status. - permalink (string | null): Public result URL. - query (string | null): Query submitted. - position (number | null): One-based position in this API result traversal, not personalized website ranking. - region_code (string | null): Requested region, if specified. - language (string | null): Requested relevance language, if specified. - order (string | null): Requested sorting order. ## YouTube trending shorts (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get trending public shorts. GET /v1/youtube/shorts/trending Cost: 2 credits per successful fresh result. Identifier: exactly one of query; primary example GB. curl 'https://api.socialdatakit.com/v1/youtube/shorts/trending?query=GB' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## Twitter/X profile (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a public profile. GET /v1/twitter/profile Cost: 1 credits per successful fresh result. Identifier: exactly one of handle; primary example nasa. curl 'https://api.socialdatakit.com/v1/twitter/profile?handle=nasa' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Stable X user ID, preserved as a string. - username (string | null): Current handle. - display_name (string | null): Public display name. - bio (string | null): Public biography. - profile_url (string | null): Public X profile URL. - created_at (string | null): Account creation timestamp. - followers (number | null): Observed follower count. - following (number | null): Observed following count. - posts (number | null): Observed post count. - listed_count (number | null): Public list membership count. - verified (boolean | null): Source verification flag; not proof of cross-platform identity. - verified_type (string | null): Source verification category. - private (boolean | null): Explicit protected-account flag. - avatar_url (string | null): Public profile image URL. - external_url (string | null): Expanded public website URL when supplied. - location (string | null): Self-described location, not verified residence. ## Twitter/X tweets (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get public tweets from a profile. GET /v1/twitter/user/tweets Cost: 2 credits per successful fresh result. Identifier: exactly one of handle; primary example nasa. curl 'https://api.socialdatakit.com/v1/twitter/user/tweets?handle=nasa' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Stable post ID, preserved as a string. - text (string | null): Post text; long-form text when supplied. - author (string | null): Public author handle when expanded. - author_id (string | null): Stable author ID. - author_display_name (string | null): Expanded display name. - author_verified (boolean | null): Explicit author verification flag. - author_avatar_url (string | null): Expanded profile image URL. - published_at (string | null): Publication timestamp. - permalink (string | null): Public post URL. - language (string | null): Source language code. - conversation_id (string | null): Conversation ID. - possibly_sensitive (boolean | null): Explicit sensitive-content flag. - likes (number | null): Public like count. - comments (number | null): Public reply count, not reply rows. - reposts (number | null): Public repost count. - quotes (number | null): Public quote count. - bookmarks (number | null): Public bookmark count when exposed. - views (number | null): Public impression count when exposed; not unique viewers. - hashtags (array | null): Source hashtags; null if not provided. - hashtags[].name (string | null): Hashtag or account handle. - hashtags[].id (string | null): Source ID when supplied. - hashtags[].source (string | null): platform; never inferred account ownership. - mentions (array | null): Source mentions; not verified account connections. - mentions[].name (string | null): Hashtag or account handle. - mentions[].id (string | null): Source ID when supplied. - mentions[].source (string | null): platform; never inferred account ownership. - media (array | null): Attached media in source order. Missing expansions remain null; URLs may expire. - media[].media_key (string | null): Source media key. - media[].type (string | null): Source media type. - media[].url (string | null): Image URL when exposed. - media[].preview_url (string | null): Preview image URL. - media[].width (number | null): Width in pixels. - media[].height (number | null): Height in pixels. - media[].duration_seconds (number | null): Duration in seconds. - media[].alt_text (string | null): Source alt text. - media[].variants (array | null): Public playback variants when exposed. - media[].variants[].url (string | null): Playback URL. - media[].variants[].content_type (string | null): MIME type. - media[].variants[].bit_rate (number | null): Bit rate when supplied. ## Twitter/X tweet (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a single public tweet. GET /v1/twitter/tweet Cost: 1 credits per successful fresh result. Identifier: exactly one of url; primary example https://x.com/nasa/status/1234567890. curl 'https://api.socialdatakit.com/v1/twitter/tweet?url=https%3A%2F%2Fx.com%2Fnasa%2Fstatus%2F1234567890' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Stable post ID, preserved as a string. - text (string | null): Post text; long-form text when supplied. - author (string | null): Public author handle when expanded. - author_id (string | null): Stable author ID. - author_display_name (string | null): Expanded display name. - author_verified (boolean | null): Explicit author verification flag. - author_avatar_url (string | null): Expanded profile image URL. - published_at (string | null): Publication timestamp. - permalink (string | null): Public post URL. - language (string | null): Source language code. - conversation_id (string | null): Conversation ID. - possibly_sensitive (boolean | null): Explicit sensitive-content flag. - likes (number | null): Public like count. - comments (number | null): Public reply count, not reply rows. - reposts (number | null): Public repost count. - quotes (number | null): Public quote count. - bookmarks (number | null): Public bookmark count when exposed. - views (number | null): Public impression count when exposed; not unique viewers. - hashtags (array | null): Source hashtags; null if not provided. - hashtags[].name (string | null): Hashtag or account handle. - hashtags[].id (string | null): Source ID when supplied. - hashtags[].source (string | null): platform; never inferred account ownership. - mentions (array | null): Source mentions; not verified account connections. - mentions[].name (string | null): Hashtag or account handle. - mentions[].id (string | null): Source ID when supplied. - mentions[].source (string | null): platform; never inferred account ownership. - media (array | null): Attached media in source order. Missing expansions remain null; URLs may expire. - media[].media_key (string | null): Source media key. - media[].type (string | null): Source media type. - media[].url (string | null): Image URL when exposed. - media[].preview_url (string | null): Preview image URL. - media[].width (number | null): Width in pixels. - media[].height (number | null): Height in pixels. - media[].duration_seconds (number | null): Duration in seconds. - media[].alt_text (string | null): Source alt text. - media[].variants (array | null): Public playback variants when exposed. - media[].variants[].url (string | null): Playback URL. - media[].variants[].content_type (string | null): MIME type. - media[].variants[].bit_rate (number | null): Bit rate when supplied. ## Twitter/X tweet transcript (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a transcript for a public video tweet. GET /v1/twitter/tweet/transcript Cost: 4 credits per successful fresh result. Identifier: exactly one of url; primary example https://x.com/nasa/status/1234567890. curl 'https://api.socialdatakit.com/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2Fnasa%2Fstatus%2F1234567890' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## Twitter/X community (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get a public community. GET /v1/twitter/community Cost: 1 credits per successful fresh result. Identifier: exactly one of url; primary example https://x.com/i/communities/1234567890. curl 'https://api.socialdatakit.com/v1/twitter/community?url=https%3A%2F%2Fx.com%2Fi%2Fcommunities%2F1234567890' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Stable community ID, preserved as a string. - name (string | null): Community name. - description (string | null): Public description. - community_url (string | null): Public community URL. - created_at (string | null): Creation timestamp. - member_count (number | null): Observed member count. - access (string | null): Source visibility; only public communities are collected. - join_policy (string | null): Membership rule; separate from visibility. ## Twitter/X community tweets (Planned: returns 501 SOURCE_NOT_IMPLEMENTED; no credits charged) Get public tweets in a community. GET /v1/twitter/community/tweets Cost: 2 credits per successful fresh result. Identifier: exactly one of url; primary example https://x.com/i/communities/1234567890. curl 'https://api.socialdatakit.com/v1/twitter/community/tweets?url=https%3A%2F%2Fx.com%2Fi%2Fcommunities%2F1234567890' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Resource identifier used by this endpoint. - author (string | null): Public creator name or handle. - published_at (string | null): Source publication date or timestamp; null when absent. - views (number | null): Observed views, where exposed by this source. - likes (number | null): Observed likes. - comments (number | null): Observed comment count, not comment rows. - media_url (string | null): Preview image URL; not a guaranteed downloadable video. - permalink (string | null): Public content URL. - duration_seconds (number | null): Duration in seconds when returned. - hashtags (array | null): Hashtags with platform or derived_text provenance. - hashtags[].name (string | null): Hashtag or account name. - hashtags[].id (string | null): Platform ID when supplied. - hashtags[].source (string | null): platform or derived_text. - mentions (array | null): Mentions with platform or derived_text provenance; text is not proof of an account relationship. - mentions[].name (string | null): Hashtag or account name. - mentions[].id (string | null): Platform ID when supplied. - mentions[].source (string | null): platform or derived_text. - category_id (string | null): YouTube category ID. - language (string | null): Default metadata language. - audio_language (string | null): Default audio language. - localized (object | null): Selected localized text. - localized.title (string | null): Title. - localized.description (string | null): Description. - localizations (object | null): Returned language-to-title/description map. - duration_iso8601 (string | null): Source ISO 8601 duration. - dimension (string | null): 2d or 3d. - definition (string | null): hd or sd. - licensed_content (boolean | null): Source licensed-content flag. - region_restriction (object | null): An omitted list differs from an empty list. An empty allowed list blocks everywhere; an empty blocked list blocks nowhere. - region_restriction.allowed (array | null): Countries where viewing is permitted. - region_restriction.blocked (array | null): Countries where viewing is blocked. - content_rating (object | null): Country/authority rating map retained without enumerating columns. - projection (string | null): Projection format. - privacy_status (string | null): Source public/unlisted status when returned without account authorization. - license (string | null): Source license. - public_stats_viewable (boolean | null): Source public-statistics setting. - made_for_kids (boolean | null): Current source designation when publicly returned; not the owner-only self-declared setting. - contains_synthetic_media (boolean | null): Source altered/synthetic-media disclosure when publicly returned; not an AI prediction. - paid_partnership (boolean | null): Explicit source paid-product-placement flag when publicly returned. - topic_ids (array | null): Legacy source topic IDs, when returned. - topic_categories (array | null): Topic-category URLs. - recording_date (string | null): Public recording date, when returned. - embed_html (string | null): Source embed markup as a string. Never execute returned HTML without sanitizing. - embed_height (number | null): Source embed height. - embed_width (number | null): Source embed width. - live_status (string | null): live, upcoming or none when supplied. - title (string | null): Video title. - description (string | null): Video description. - channel_id (string | null): Owning channel ID. - tags (array | null): Keyword tags; distinct from hashtags. - thumbnails (array | null): Returned thumbnail variants and dimensions. - thumbnails[].url (string | null): Source URL. - thumbnails[].width (number | null): Width in pixels. - thumbnails[].height (number | null): Height in pixels. - thumbnails[].asset_type (string | null): image, video, thumbnail or avatar. - thumbnails[].variant (string | null): Source variant when known. - thumbnails[].expires_at (string | null): Expiry timestamp when known. - author_avatar_url (string | null): Channel avatar from the watch page. - channel_url (string | null): Channel URL built from the observed channel ID. - upload_date (string | null): Source upload date, separate from publication date. - available_countries (array | null): Allowed country list when the player exposes it; no inferred blocked countries. - unlisted (boolean | null): Source unlisted flag. - family_safe (boolean | null): Source family-safe flag; not the made-for-kids designation. - counts_rounded (object | null): Precision of observed counters. Unknown precision is null. - counts_rounded.views (boolean | null): Views rounded. - counts_rounded.likes (boolean | null): Likes rounded. - counts_rounded.comments (boolean | null): Comments rounded. - caption_tracks (array | null): Caption-track metadata without caption text. - caption_tracks[].language (string | null): Source language code. - caption_tracks[].language_name (string | null): Source language label. - caption_tracks[].generated (boolean | null): True for an automatic caption track. - caption_tracks[].translatable (boolean | null): Source translation capability. - category (string | null): Source category name. - is_live (boolean | null): Explicit current live state. - is_live_content (boolean | null): Explicit live-content classification. - captions_available (boolean | null): Caption-track availability when observable. - embeddable (boolean | null): Player embed permission when returned. - live (object | null): Returned broadcast start/end times and live-now state. - live.actual_start_time (string | null): Source broadcast start time. - live.actual_end_time (string | null): Source broadcast end time. - live.is_live_now (boolean | null): Explicit live-now state. - live.scheduled_start_time (string | null): Scheduled start time. - live.scheduled_end_time (string | null): Scheduled end time. - live.concurrent_viewers (number | null): Current live viewers, when public. - live.active_live_chat_id (string | null): Active public live-chat ID when supplied. ## Meta company ads (Preview: check status before use) Preview contract for a company's public Meta Ad Library ads, creative assets, delivery dates and publisher platforms. Live access is pending source validation. Filter by country, status, media, language and start date. GET /v1/facebook/adLibrary/company/ads (also POST with all parameters in a JSON body, max 64 KiB, no URL query) Cost: 1 credits per successful fresh result. Identifier: exactly one of pageId, companyName; primary example 367152833370567. Optional: country, Country code, or ALL (default), example GB. Optional: status, Ad status (default ACTIVE), example ACTIVE. Optional: media_type, Media format (default ALL), example VIDEO. Optional: language, Two-letter language code, example EN. Optional: sort_by, Sort order (default total_impressions), example total_impressions. Optional: start_date, Earliest ad start date, YYYY-MM-DD, example 2026-01-01. Optional: end_date, Latest ad start date, YYYY-MM-DD, example 2026-09-19. curl 'https://api.socialdatakit.com/v1/facebook/adLibrary/company/ads?pageId=367152833370567' \ -H 'x-api-key: YOUR_API_KEY' Fields: - id (string | null): Meta Ad Library archive ID, kept as a string. - ad_archive_id (string | null): Meta Ad Library archive ID. - ad_library_url (string | null): Public Ad Library link for this ad. - page_id (string | null): Advertiser Facebook Page ID. - page_name (string | null): Advertiser name shown by Meta. - is_active (boolean | null): Whether Meta reports this ad as active. - start_date (string | null): First delivery date in UTC, when supplied. - end_date (string | null): Delivery end date in UTC, when supplied. - collation_id (string | null): Meta's identifier grouping related ad variations; not an Ads Manager campaign ID. - collation_count (number | null): Number of variations reported for the group. - publisher_platforms (array | null): Platforms where the ad is published. - creative (object | null): Public ad creative. Media links may expire; unavailable values remain null. - creative.body (string | null): Ad copy as plain text. - creative.title (string | null): Creative headline. - creative.caption (string | null): Display caption. - creative.description (string | null): Link description. - creative.display_format (string | null): Meta creative format. - creative.cta_text (string | null): Call-to-action label. - creative.cta_type (string | null): Call-to-action type. - creative.destination_url (string | null): Advertised destination URL. - creative.images (array | null): Public image assets. - creative.images[].url (string | null): Public image URL; may expire. - creative.images[].resized_url (string | null): Resized image URL when supplied. - creative.videos (array | null): Public video assets. - creative.videos[].hd_url (string | null): HD video URL when supplied. - creative.videos[].sd_url (string | null): SD video URL when supplied. - creative.videos[].preview_url (string | null): Video preview image URL. - creative.cards (array | null): Ordered carousel cards. - creative.cards[].title (string | null): Card headline. - creative.cards[].body (string | null): Card text. - creative.cards[].destination_url (string | null): Card destination. - creative.cards[].image_url (string | null): Card image. - creative.cards[].video_hd_url (string | null): Card HD video. - creative.cards[].video_sd_url (string | null): Card SD video. - creative.cards[].cta_text (string | null): Card call to action.