---
title: "Twitter Video Metadata"
method: POST
path: "/twitter/video/metadata"
---

# Twitter Video Metadata

`POST /twitter/video/metadata`

Get Twitter video metadata.

## Request body

- object
  - `video_url` string, required — The Twitter video URL
  - `channel` 'apify' | 'rapid' | 'memories.ai', required — The channel name. Supported values: apify, rapid, memories.ai

## Response `200`

Video metadata information with detailed Twitter/X data

- object
  - `code` string — Response code indicating the result status
  - `msg` string — Response message describing the operation result
  - `data` object[] — Array containing Twitter/X tweet metadata objects
    - `type` string — Content type
    - `id` string — Tweet ID
    - `url` string — X.com URL
    - `twitterUrl` string — Twitter.com URL
    - `text` string — Tweet text
    - `fullText` string — Full tweet text
    - `source` string — Source of the tweet
    - `retweetCount` number — Number of retweets
    - `replyCount` number — Number of replies
    - `likeCount` number — Number of likes
    - `quoteCount` number — Number of quotes
    - `viewCount` number — Number of views
    - `createdAt` string — Creation timestamp
    - `lang` string — Language code
    - `bookmarkCount` number — Number of bookmarks
    - `isReply` boolean — Whether the tweet is a reply
    - `conversationId` string — Conversation ID
    - `possiblySensitive` boolean — Whether the content is possibly sensitive
    - `isPinned` boolean — Whether the tweet is pinned
    - `author` object — Author/user information
      - `type` string
      - `userName` string — Author username
      - `url` string
      - `twitterUrl` string
      - `id` string
      - `name` string — Author display name
      - `isVerified` boolean — Whether the author is verified
      - `verifiedType` string — Verification type
      - `isBlueVerified` boolean — Whether the author has blue verification
      - `profilePicture` string — Profile picture URL
      - `coverPicture` string — Cover picture URL
      - `description` string — Author description
      - `followers` number — Number of followers
      - `following` number — Number of users following
      - `createdAt` string — Account creation timestamp
    - `extendedEntities` object — Extended media entities
      - `media` object[] — Array of media objects
        - `display_url` string
        - `expanded_url` string
        - `id_str` string
        - `type` string — Media type
        - `media_url_https` string — Media URL
        - `video_info` object — Video information
          - `aspect_ratio` number[] — Video aspect ratio
          - `duration_millis` number — Video duration in milliseconds
          - `variants` object[] — Array of video variants with different bitrates
            - `content_type` string
            - `url` string
            - `bitrate` number — Video bitrate
    - `isRetweet` boolean — Whether the tweet is a retweet
    - `isQuote` boolean — Whether the tweet is a quote
    - `media` string[] — Array of media URLs
    - `isConversationControlled` boolean — Whether the conversation is controlled
  - `success` boolean — Indicates whether the operation was successful
  - `failed` boolean — Indicates whether the operation failed

---

[API](https://skmtc.net/memories/apis/screenplay-extraction-api.md) · [All operations](https://skmtc.net/memories/apis/screenplay-extraction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memories/screenplay-extraction-api/versions/720c8c144ddc/schema)