Skip to main content
GET
/
v1
/
scrape
/
twitter
/
tweet
Tweet Details
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/twitter/tweet \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "__typename": "Tweet",
    "rest_id": "1947295471082316145",
    "core": {
      "user_results": {
        "result": {
          "__typename": "User",
          "id": "VXNlcjoxNTc3MjQxNDAz",
          "rest_id": "1577241403",
          "affiliates_highlighted_label": {},
          "avatar": {
            "image_url": "https://pbs.twimg.com/profile_images/1996831016720486400/vycHz0uG_normal.jpg"
          },
          "core": {
            "created_at": "Mon Jul 08 09:31:59 +0000 2013",
            "name": "@levelsio",
            "screen_name": "levelsio"
          },
          "dm_permissions": {},
          "is_blue_verified": true,
          "legacy": {
            "default_profile": false,
            "default_profile_image": false,
            "description": "🇪🇺https://t.co/NdorAWqJC3 @euacc \n📸https://t.co/lAyoqmSBRX $110k/m \n🏡https://t.co/1oqUgfD6CZ $36K/m \n🛰https://t.co/ZHSvI2wjyW $38K/m \n🌍https://t.co/UXK5AFqCaQ $17K/m \n👙https://t.co/RyXpqGuFM3 $17K/m \n💾@pieter $0K/m",
            "entities": {
              "description": {
                "urls": {
                  "0": {
                    "display_url": "euacc.com",
                    "expanded_url": "http://euacc.com",
                    "url": "https://t.co/NdorAWqJC3",
                    "indices": {
                      "0": 2,
                      "1": 25
                    }
                  }
                }
              },
              "url": {
                "urls": {
                  "0": {
                    "display_url": "readMAKE.com",
                    "expanded_url": "http://readMAKE.com",
                    "url": "https://t.co/IFRqZDK2Lw",
                    "indices": {
                      "0": 0,
                      "1": 23
                    }
                  }
                }
              }
            },
            "fast_followers_count": 0,
            "favourites_count": 162735,
            "followers_count": 819619,
            "friends_count": 2704,
            "has_custom_timelines": true,
            "is_translator": false,
            "listed_count": 8339,
            "media_count": 18333,
            "normal_followers_count": 819619,
            "pinned_tweet_ids_str": {
              "0": "1947295471082316145"
            },
            "possibly_sensitive": false,
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
            "profile_interstitial_type": "",
            "statuses_count": 169031,
            "translator_type": "none",
            "url": "https://t.co/IFRqZDK2Lw",
            "withheld_in_countries": {}
          },
          "location": {
            "location": "📕 My book $6K/m  👉"
          },
          "media_permissions": {},
          "parody_commentary_fan_label": "None",
          "profile_image_shape": "Circle",
          "professional": {
            "rest_id": "1800203633688027410",
            "professional_type": "Creator",
            "category": {}
          },
          "privacy": {
            "protected": false
          },
          "relationship_perspectives": {},
          "tipjar_settings": {
            "is_enabled": false,
            "bandcamp_handle": "",
            "bitcoin_handle": "",
            "cash_app_handle": "",
            "ethereum_handle": "",
            "gofundme_handle": "",
            "patreon_handle": "",
            "pay_pal_handle": "",
            "venmo_handle": ""
          },
          "verification": {
            "verified": false
          }
        }
      }
    },
    "card": {
      "rest_id": "https://t.co/p8v5Ka0PYE",
      "legacy": {
        "binding_values": {
          "0": {
            "key": "player_url",
            "value": {
              "string_value": "https://www.youtube.com/embed/StkCdcZ1ovE",
              "type": "STRING"
            }
          }
        },
        "card_platform": {
          "platform": {
            "audience": {
              "name": "production"
            },
            "device": {
              "name": "Swift",
              "version": "12"
            }
          }
        },
        "name": "player",
        "url": "https://t.co/p8v5Ka0PYE",
        "user_refs_results": {
          "0": {
            "result": {
              "__typename": "User",
              "id": "VXNlcjoxMDIyODI3Mg==",
              "rest_id": "10228272",
              "affiliates_highlighted_label": {},
              "avatar": {
                "image_url": "https://pbs.twimg.com/profile_images/1984471345854566400/5pd8GpgC_normal.jpg"
              },
              "core": {
                "created_at": "Tue Nov 13 21:43:46 +0000 2007",
                "name": "YouTube",
                "screen_name": "YouTube"
              },
              "dm_permissions": {},
              "is_blue_verified": true,
              "legacy": {
                "default_profile": false,
                "default_profile_image": false,
                "description": "like & subscribe",
                "entities": {
                  "description": {
                    "urls": {}
                  },
                  "url": {
                    "urls": {
                      "0": {
                        "display_url": "youtube.com/recap",
                        "expanded_url": "http://youtube.com/recap",
                        "url": "https://t.co/URnyVVv35T",
                        "indices": {
                          "0": 0,
                          "1": 23
                        }
                      }
                    }
                  }
                },
                "fast_followers_count": 0,
                "favourites_count": 6023,
                "followers_count": 68057635,
                "friends_count": 1143,
                "has_custom_timelines": true,
                "is_translator": false,
                "listed_count": 74442,
                "media_count": 16081,
                "normal_followers_count": 68057635,
                "pinned_tweet_ids_str": {},
                "possibly_sensitive": false,
                "profile_banner_url": "https://pbs.twimg.com/profile_banners/10228272/1764705659",
                "profile_interstitial_type": "",
                "statuses_count": 60670,
                "translator_type": "regular",
                "url": "https://t.co/URnyVVv35T",
                "withheld_in_countries": {}
              },
              "location": {
                "location": "San Bruno, CA"
              },
              "media_permissions": {},
              "parody_commentary_fan_label": "None",
              "profile_image_shape": "Square",
              "privacy": {
                "protected": false
              },
              "relationship_perspectives": {},
              "tipjar_settings": {
                "is_enabled": false,
                "bandcamp_handle": "",
                "bitcoin_handle": "",
                "cash_app_handle": "",
                "ethereum_handle": "",
                "gofundme_handle": "",
                "patreon_handle": "",
                "pay_pal_handle": "",
                "venmo_handle": ""
              },
              "verification": {
                "verified": false,
                "verified_type": "Business"
              }
            }
          }
        }
      }
    },
    "unmention_data": {},
    "edit_control": {
      "edit_tweet_ids": {
        "0": "1947295471082316145"
      },
      "editable_until_msecs": "1753109993000",
      "is_edit_eligible": true,
      "edits_remaining": "5"
    },
    "is_translatable": false,
    "views": {
      "count": "686535",
      "state": "EnabledWithCount"
    },
    "source": "<a href=\"https://mobile.twitter.com\" rel=\"nofollow\">Twitter Web App</a>",
    "grok_analysis_button": true,
    "quoted_status_result": {
      "result": {
        "__typename": "Tweet",
        "rest_id": "1942978418603360459",
        "core": {
          "user_results": {
            "result": {
              "__typename": "User",
              "id": "VXNlcjo1NDE4OTEy",
              "rest_id": "5418912",
              "affiliates_highlighted_label": {},
              "avatar": {
                "image_url": "https://pbs.twimg.com/profile_images/2464132281/jbbxl9p7ratdyuposrif_normal.jpeg"
              },
              "core": {
                "created_at": "Mon Apr 23 02:53:59 +0000 2007",
                "name": "John Collison",
                "screen_name": "collision"
              },
              "dm_permissions": {},
              "is_blue_verified": true,
              "legacy": {
                "default_profile": false,
                "default_profile_image": false,
                "description": "Co-founder of @stripe.",
                "entities": {
                  "description": {
                    "urls": {}
                  },
                  "url": {
                    "urls": {
                      "0": {
                        "display_url": "johncollison.ie",
                        "expanded_url": "http://johncollison.ie",
                        "url": "http://t.co/SjMCy56bjS",
                        "indices": {
                          "0": 0,
                          "1": 22
                        }
                      }
                    }
                  }
                },
                "fast_followers_count": 0,
                "favourites_count": 35923,
                "followers_count": 223920,
                "friends_count": 1416,
                "has_custom_timelines": true,
                "is_translator": false,
                "listed_count": 2900,
                "media_count": 457,
                "normal_followers_count": 223920,
                "pinned_tweet_ids_str": {},
                "possibly_sensitive": false,
                "profile_banner_url": "https://pbs.twimg.com/profile_banners/5418912/1392613775",
                "profile_interstitial_type": "",
                "statuses_count": 9433,
                "translator_type": "none",
                "url": "http://t.co/SjMCy56bjS",
                "withheld_in_countries": {}
              },
              "location": {
                "location": "California / Ireland"
              },
              "media_permissions": {},
              "parody_commentary_fan_label": "None",
              "profile_image_shape": "Circle",
              "privacy": {
                "protected": false
              },
              "relationship_perspectives": {},
              "tipjar_settings": {
                "is_enabled": false,
                "bandcamp_handle": "",
                "bitcoin_handle": "",
                "cash_app_handle": "",
                "ethereum_handle": "",
                "gofundme_handle": "",
                "patreon_handle": "",
                "pay_pal_handle": "",
                "venmo_handle": ""
              },
              "verification": {
                "verified": false
              }
            }
          }
        },
        "unmention_data": {},
        "edit_control": {
          "edit_tweet_ids": {
            "0": "1942978418603360459"
          },
          "editable_until_msecs": "1752080728000",
          "is_edit_eligible": false,
          "edits_remaining": "5"
        },
        "is_translatable": false,
        "views": {
          "count": "1299828",
          "state": "EnabledWithCount"
        },
        "source": "<a href=\"https://mobile.twitter.com\" rel=\"nofollow\">Twitter Web App</a>",
        "note_tweet": {
          "is_expandable": true,
          "note_tweet_results": {
            "result": {
              "id": "Tm90ZVR3ZWV0OjE5NDI5Nzg0MTg0NzM0MTQ2NTY=",
              "text": "Pieter Levels (@levelsio) and I sat down over a pint to talk about how he’s making $3m a year as a one-person company, what Europe can do to spur economic growth, and his experience as a digital nomad in over 150 cities across 40 countries.\n\nTimestamps\n00:00 Intro\n00:37 Pieter’s resume\n01:33 Trying to make money online as a 12 year old\n02:43 Being one of the first YouTube creators\n03:18 Who should indie hack\n04:31 What Pieter hates about VC-backed businesses\n07:51 Who is digital nomading for?\n09:15 Learning from @patio11\n10:17 125k tweets and the brand of @levelsio\n10:59 Getting referrals from ChatGPT\n11:43 What Pieter automates with AI\n13:02 Investing and home country bias\n15:05 Hacking thermostats\n15:57 EU acceleration movement\n18:34 Entrepreneurship in the EU\n19:26 Pieter's reflections on Stripe’s API\n21:21 Looking 5 years into the future",
              "entity_set": {
                "hashtags": {},
                "symbols": {},
                "timestamps": {
                  "0": {
                    "indices": {
                      "0": 253,
                      "1": 258
                    },
                    "seconds": 0,
                    "text": "00:00"
                  }
                },
                "urls": {},
                "user_mentions": {
                  "0": {
                    "id_str": "1577241403",
                    "name": "@levelsio",
                    "screen_name": "levelsio",
                    "indices": {
                      "0": 15,
                      "1": 24
                    }
                  }
                }
              },
              "richtext": {
                "richtext_tags": {}
              },
              "media": {
                "inline_media": {}
              }
            }
          }
        },
        "grok_analysis_button": true,
        "legacy": {
          "bookmark_count": 4973,
          "bookmarked": false,
          "created_at": "Wed Jul 09 16:05:28 +0000 2025",
          "conversation_id_str": "1942978418603360459",
          "display_text_range": {
            "0": 0,
            "1": 279
          },
          "entities": {
            "hashtags": {},
            "media": {
              "0": {
                "display_url": "pic.x.com/quzVSeRewx",
                "expanded_url": "https://x.com/collision/status/1942978418603360459/video/1",
                "id_str": "1942969493073850368",
                "indices": {
                  "0": 280,
                  "1": 303
                },
                "media_key": "13_1942969493073850368",
                "media_url_https": "https://pbs.twimg.com/amplify_video_thumb/1942969493073850368/img/z_Fn_lAbNGx06VdZ.jpg",
                "type": "video",
                "url": "https://t.co/quzVSeRewx",
                "additional_media_info": {
                  "monetizable": false
                },
                "ext_media_availability": {
                  "status": "Available"
                },
                "sizes": {
                  "large": {
                    "h": 1080,
                    "w": 1920,
                    "resize": "fit"
                  },
                  "medium": {
                    "h": 675,
                    "w": 1200,
                    "resize": "fit"
                  },
                  "small": {
                    "h": 383,
                    "w": 680,
                    "resize": "fit"
                  },
                  "thumb": {
                    "h": 150,
                    "w": 150,
                    "resize": "crop"
                  }
                },
                "original_info": {
                  "height": 1080,
                  "width": 1920,
                  "focus_rects": {}
                },
                "video_info": {
                  "aspect_ratio": {
                    "0": 16,
                    "1": 9
                  },
                  "duration_millis": 1356855,
                  "variants": {
                    "0": {
                      "content_type": "application/x-mpegURL",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/pl/RHDtWbaUYdk11aY-.m3u8?tag=21&v=2ca"
                    },
                    "1": {
                      "bitrate": 256000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/480x270/j30m7cMCC68d0aBs.mp4?tag=21"
                    },
                    "2": {
                      "bitrate": 832000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/640x360/eQxW8udanbWovD3b.mp4?tag=21"
                    },
                    "3": {
                      "bitrate": 2176000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/1280x720/lgpMDUR2wxl3hxCF.mp4?tag=21"
                    },
                    "4": {
                      "bitrate": 10368000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/1920x1080/J_oYdWdt8lpCBcrA.mp4?tag=21"
                    }
                  }
                },
                "media_results": {
                  "result": {
                    "media_key": "13_1942969493073850368"
                  }
                }
              }
            },
            "symbols": {},
            "timestamps": {
              "0": {
                "indices": {
                  "0": 253,
                  "1": 258
                },
                "seconds": 0,
                "text": "00:00"
              }
            },
            "urls": {},
            "user_mentions": {
              "0": {
                "id_str": "1577241403",
                "name": "@levelsio",
                "screen_name": "levelsio",
                "indices": {
                  "0": 15,
                  "1": 24
                }
              }
            }
          },
          "extended_entities": {
            "media": {
              "0": {
                "display_url": "pic.x.com/quzVSeRewx",
                "expanded_url": "https://x.com/collision/status/1942978418603360459/video/1",
                "id_str": "1942969493073850368",
                "indices": {
                  "0": 280,
                  "1": 303
                },
                "media_key": "13_1942969493073850368",
                "media_url_https": "https://pbs.twimg.com/amplify_video_thumb/1942969493073850368/img/z_Fn_lAbNGx06VdZ.jpg",
                "type": "video",
                "url": "https://t.co/quzVSeRewx",
                "additional_media_info": {
                  "monetizable": false
                },
                "ext_media_availability": {
                  "status": "Available"
                },
                "sizes": {
                  "large": {
                    "h": 1080,
                    "w": 1920,
                    "resize": "fit"
                  },
                  "medium": {
                    "h": 675,
                    "w": 1200,
                    "resize": "fit"
                  },
                  "small": {
                    "h": 383,
                    "w": 680,
                    "resize": "fit"
                  },
                  "thumb": {
                    "h": 150,
                    "w": 150,
                    "resize": "crop"
                  }
                },
                "original_info": {
                  "height": 1080,
                  "width": 1920,
                  "focus_rects": {}
                },
                "video_info": {
                  "aspect_ratio": {
                    "0": 16,
                    "1": 9
                  },
                  "duration_millis": 1356855,
                  "variants": {
                    "0": {
                      "content_type": "application/x-mpegURL",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/pl/RHDtWbaUYdk11aY-.m3u8?tag=21&v=2ca"
                    },
                    "1": {
                      "bitrate": 256000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/480x270/j30m7cMCC68d0aBs.mp4?tag=21"
                    },
                    "2": {
                      "bitrate": 832000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/640x360/eQxW8udanbWovD3b.mp4?tag=21"
                    },
                    "3": {
                      "bitrate": 2176000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/1280x720/lgpMDUR2wxl3hxCF.mp4?tag=21"
                    },
                    "4": {
                      "bitrate": 10368000,
                      "content_type": "video/mp4",
                      "url": "https://video.twimg.com/amplify_video/1942969493073850368/vid/avc1/1920x1080/J_oYdWdt8lpCBcrA.mp4?tag=21"
                    }
                  }
                },
                "media_results": {
                  "result": {
                    "media_key": "13_1942969493073850368"
                  }
                }
              }
            }
          },
          "favorite_count": 3773,
          "favorited": false,
          "full_text": "Pieter Levels (@levelsio) and I sat down over a pint to talk about how he’s making $3m a year as a one-person company, what Europe can do to spur economic growth, and his experience as a digital nomad in over 150 cities across 40 countries.\n\nTimestamps\n00:00 Intro\n00:37 Pieter’s https://t.co/quzVSeRewx",
          "is_quote_status": false,
          "lang": "en",
          "possibly_sensitive": false,
          "possibly_sensitive_editable": true,
          "quote_count": 77,
          "reply_count": 171,
          "retweet_count": 289,
          "retweeted": false,
          "user_id_str": "5418912",
          "id_str": "1942978418603360459"
        }
      }
    },
    "legacy": {
      "bookmark_count": 670,
      "bookmarked": false,
      "created_at": "Mon Jul 21 13:59:53 +0000 2025",
      "conversation_id_str": "1947295471082316145",
      "display_text_range": {
        "0": 0,
        "1": 77
      },
      "entities": {
        "hashtags": {},
        "symbols": {},
        "timestamps": {},
        "urls": {
          "0": {
            "display_url": "youtube.com/watch?v=StkCdc…",
            "expanded_url": "https://www.youtube.com/watch?v=StkCdcZ1ovE",
            "url": "https://t.co/p8v5Ka0PYE",
            "indices": {
              "0": 54,
              "1": 77
            }
          }
        },
        "user_mentions": {
          "0": {
            "id_str": "5418912",
            "name": "John Collison",
            "screen_name": "collision",
            "indices": {
              "0": 18,
              "1": 28
            }
          }
        }
      },
      "favorite_count": 818,
      "favorited": false,
      "full_text": "This podcast with @collision is now on YouTube too 😊\n\nhttps://t.co/p8v5Ka0PYE",
      "is_quote_status": true,
      "lang": "en",
      "possibly_sensitive": false,
      "possibly_sensitive_editable": true,
      "quote_count": 7,
      "quoted_status_id_str": "1942978418603360459",
      "quoted_status_permalink": {
        "url": "https://t.co/TctFLcI8du",
        "expanded": "https://twitter.com/collision/status/1942978418603360459",
        "display": "x.com/collision/stat…"
      },
      "reply_count": 49,
      "retweet_count": 66,
      "retweeted": false,
      "user_id_str": "1577241403",
      "id_str": "1947295471082316145"
    }
  },
  "credits_used": 1,
  "endpoint": "twitter/tweet"
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
url
string
required

Tweet URL

​
trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

Key Response Fields:

  • rest_id: Tweet ID string
  • legacy.full_text: Full tweet text content
  • legacy.created_at: Tweet creation timestamp
  • legacy.favorite_count: Like count
  • legacy.retweet_count: Retweet count
  • legacy.reply_count: Reply count
  • legacy.quote_count: Quote tweet count
  • legacy.bookmark_count: Bookmark count
  • views.count: Total view count
  • legacy.entities.media: Attached photos/videos
  • legacy.entities.urls: Expanded URLs in the tweet
  • core.user_results.result.core.screen_name / name: Author @handle and display name
  • quoted_status_result: Nested object for the quoted tweet (if applicable)
  • card.legacy.binding_values: Rich card data (YouTube embeds, link previews, etc.)
  • Use trim=true for a leaner response without deeply nested user objects