> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bridgly.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch a tweet with its reply thread



## OpenAPI

````yaml /openapi.json post /x/get-tweet-detail
openapi: 3.1.0
info:
  title: Bridgly API
  description: >-
    Web scraping API for LinkedIn, X (Twitter) and Reddit. Authenticated
    endpoints accept a Bridgly API key (`bgly_…`) via `Authorization: Bearer
    <token>`.
  version: 1.0.0
servers:
  - url: https://api.bridgly.app
    description: Production
  - url: http://localhost:4000
    description: Local
security: []
tags:
  - name: LinkedIn
    description: Scrape LinkedIn profiles, companies, posts, and search.
  - name: Reddit
    description: Scrape Reddit posts, subreddits, users, and search.
  - name: X (Twitter)
    description: Scrape tweets and search X.
paths:
  /x/get-tweet-detail:
    post:
      tags:
        - X (Twitter)
      summary: Fetch a tweet with its reply thread
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tweetId:
                  type: string
                  description: Numeric ID of the focal tweet to expand, e.g. "1234567890".
                accountId:
                  description: >-
                    Pin the scrape to a specific account instead of LRU
                    rotation.
                  type: string
                cursor:
                  description: Pagination cursor for loading more replies.
                  type: string
              required:
                - tweetId
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  timeMs:
                    type: number
                    description: >-
                      Wall-clock time the request took to complete, in
                      milliseconds.
                  creditsCost:
                    type: number
                    description: Number of account credits this request consumed.
                  data:
                    type: object
                    properties:
                      tweet:
                        type: object
                        properties:
                          id:
                            type: string
                            description: Numeric tweet ID
                          text:
                            type: string
                            description: Full text of the tweet
                          author:
                            type: object
                            properties:
                              userId:
                                type: string
                              username:
                                type: string
                                description: Handle without the @ e.g. "elonmusk"
                              displayName:
                                type: string
                              bio:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              avatarUrl:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              followerCount:
                                type: number
                              followingCount:
                                type: number
                              isVerified:
                                type: boolean
                              isBlueVerified:
                                type: boolean
                            required:
                              - userId
                              - username
                              - displayName
                              - bio
                              - avatarUrl
                              - followerCount
                              - followingCount
                              - isVerified
                              - isBlueVerified
                            additionalProperties: false
                          createdAt:
                            description: When the tweet was posted
                            type: string
                            format: date-time
                          conversationId:
                            type: string
                            description: ID of the root tweet in this thread
                          replyCount:
                            type: number
                          retweetCount:
                            type: number
                          likeCount:
                            type: number
                          quoteCount:
                            type: number
                          bookmarkCount:
                            anyOf:
                              - type: number
                              - type: 'null'
                          viewCount:
                            anyOf:
                              - type: number
                              - type: 'null'
                          replyToTweetId:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: Parent tweet ID if this is a reply
                          replyToUserId:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: Author of the parent tweet
                          lang:
                            anyOf:
                              - type: string
                              - type: 'null'
                            description: Language code e.g. "en"
                          isSensitive:
                            type: boolean
                          hashtags:
                            type: array
                            items:
                              type: string
                            description: 'Hashtag text without the # symbol'
                          mentions:
                            type: array
                            items:
                              type: object
                              properties:
                                userId:
                                  type: string
                                username:
                                  type: string
                                displayName:
                                  type: string
                              required:
                                - userId
                                - username
                                - displayName
                              additionalProperties: false
                          urls:
                            type: array
                            items:
                              type: object
                              properties:
                                shortUrl:
                                  type: string
                                  description: t.co short URL as it appears in the text
                                expandedUrl:
                                  type: string
                                  description: The actual destination URL
                                displayUrl:
                                  type: string
                                  description: Human-readable label e.g. "github.com/..."
                              required:
                                - shortUrl
                                - expandedUrl
                                - displayUrl
                              additionalProperties: false
                          media:
                            type: array
                            items:
                              type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - photo
                                    - video
                                    - animated_gif
                                url:
                                  type: string
                              required:
                                - type
                                - url
                              additionalProperties: false
                        required:
                          - id
                          - text
                          - author
                          - createdAt
                          - conversationId
                          - replyCount
                          - retweetCount
                          - likeCount
                          - quoteCount
                          - bookmarkCount
                          - viewCount
                          - replyToTweetId
                          - replyToUserId
                          - lang
                          - isSensitive
                          - hashtags
                          - mentions
                          - urls
                          - media
                        additionalProperties: false
                      replies:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Numeric tweet ID
                            text:
                              type: string
                              description: Full text of the tweet
                            author:
                              type: object
                              properties:
                                userId:
                                  type: string
                                username:
                                  type: string
                                  description: Handle without the @ e.g. "elonmusk"
                                displayName:
                                  type: string
                                bio:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                avatarUrl:
                                  anyOf:
                                    - type: string
                                    - type: 'null'
                                followerCount:
                                  type: number
                                followingCount:
                                  type: number
                                isVerified:
                                  type: boolean
                                isBlueVerified:
                                  type: boolean
                              required:
                                - userId
                                - username
                                - displayName
                                - bio
                                - avatarUrl
                                - followerCount
                                - followingCount
                                - isVerified
                                - isBlueVerified
                              additionalProperties: false
                            createdAt:
                              description: When the tweet was posted
                              type: string
                              format: date-time
                            conversationId:
                              type: string
                              description: ID of the root tweet in this thread
                            replyCount:
                              type: number
                            retweetCount:
                              type: number
                            likeCount:
                              type: number
                            quoteCount:
                              type: number
                            bookmarkCount:
                              anyOf:
                                - type: number
                                - type: 'null'
                            viewCount:
                              anyOf:
                                - type: number
                                - type: 'null'
                            replyToTweetId:
                              anyOf:
                                - type: string
                                - type: 'null'
                              description: Parent tweet ID if this is a reply
                            replyToUserId:
                              anyOf:
                                - type: string
                                - type: 'null'
                              description: Author of the parent tweet
                            lang:
                              anyOf:
                                - type: string
                                - type: 'null'
                              description: Language code e.g. "en"
                            isSensitive:
                              type: boolean
                            hashtags:
                              type: array
                              items:
                                type: string
                              description: 'Hashtag text without the # symbol'
                            mentions:
                              type: array
                              items:
                                type: object
                                properties:
                                  userId:
                                    type: string
                                  username:
                                    type: string
                                  displayName:
                                    type: string
                                required:
                                  - userId
                                  - username
                                  - displayName
                                additionalProperties: false
                            urls:
                              type: array
                              items:
                                type: object
                                properties:
                                  shortUrl:
                                    type: string
                                    description: t.co short URL as it appears in the text
                                  expandedUrl:
                                    type: string
                                    description: The actual destination URL
                                  displayUrl:
                                    type: string
                                    description: Human-readable label e.g. "github.com/..."
                                required:
                                  - shortUrl
                                  - expandedUrl
                                  - displayUrl
                                additionalProperties: false
                            media:
                              type: array
                              items:
                                type: object
                                properties:
                                  type:
                                    type: string
                                    enum:
                                      - photo
                                      - video
                                      - animated_gif
                                  url:
                                    type: string
                                required:
                                  - type
                                  - url
                                additionalProperties: false
                          required:
                            - id
                            - text
                            - author
                            - createdAt
                            - conversationId
                            - replyCount
                            - retweetCount
                            - likeCount
                            - quoteCount
                            - bookmarkCount
                            - viewCount
                            - replyToTweetId
                            - replyToUserId
                            - lang
                            - isSensitive
                            - hashtags
                            - mentions
                            - urls
                            - media
                          additionalProperties: false
                        description: First page of top-level replies
                    required:
                      - tweet
                      - replies
                    additionalProperties: false
                required:
                  - timeMs
                  - creditsCost
                  - data
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '402':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                    description: Human-readable description of what went wrong.
                required:
                  - status
                  - message
                additionalProperties: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A Bridgly API key (`bgly_…`). Metered endpoints deduct credits from the
        resolved account.

````