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

# Grok analysis of a tweet

> Grok's analysis/summary of a tweet — the same as X's "Explain this post". First turn: pass tweet_id. Follow-up turn: pass the returned conversation_id + a prompt to ask in context (multi-turn). Runs on a Grok-capable account from a rotating pool; 503 if none is free, 409 if the conversation_id has expired.



## OpenAPI

````yaml /openapi-spec/xshot.yaml get /twitter/tweet/grok
openapi: 3.0.3
info:
  title: Xshot REST API
  version: 1.0.0
  description: >
    Twitter/X data API. Access user profiles, tweets, communities, lists,
    spaces, and trends.


    All endpoints require authentication via `api_key` query parameter,
    `x-api-key` header, or `Authorization: Bearer` header.
  contact:
    name: Xshot
    url: https://api.xshot.fun
servers:
  - url: https://api.xshot.fun
    description: Production
security:
  - ApiKeyQuery: []
  - ApiKeyHeader: []
  - BearerAuth: []
paths:
  /twitter/tweet/grok:
    get:
      tags:
        - Tweets
      summary: Grok analysis of a tweet
      description: >-
        Grok's analysis/summary of a tweet — the same as X's "Explain this
        post". First turn: pass tweet_id. Follow-up turn: pass the returned
        conversation_id + a prompt to ask in context (multi-turn). Runs on a
        Grok-capable account from a rotating pool; 503 if none is free, 409 if
        the conversation_id has expired.
      operationId: getTweetGrok
      parameters:
        - name: tweet_id
          in: query
          required: false
          description: Tweet ID. Required unless conversation_id is given.
          schema:
            type: string
          example: '2072748299451519436'
        - name: conversation_id
          in: query
          required: false
          description: >-
            Continue a previous call's conversation (requires prompt). Keeps the
            tweet + prior answer as context.
          schema:
            type: string
        - name: prompt
          in: query
          required: false
          description: >-
            Custom question. Optional on the first turn; required with
            conversation_id.
          schema:
            type: string
        - name: model
          in: query
          required: false
          description: Grok model id. Default grok-3-latest.
          schema:
            type: string
        - name: suggest
          in: query
          required: false
          description: >-
            "ticker" (or a custom instruction) — summarize AND propose/extract
            meme-coin tickers in one call. Adds a `tickers` array. On a crypto
            post it extracts the real token; otherwise it proposes fitting ones.
          schema:
            type: string
        - name: extract
          in: query
          required: false
          description: >-
            "token" — Grok 2-turn extraction + on-chain resolution in one call.
            Adds `extracted` (ticker/name/contract/chain) and `token` (resolved
            on-chain token with address/chain/liquidity/market_cap), or null.
          schema:
            type: string
      responses:
        '200':
          description: Grok answer
          content:
            application/json:
              schema:
                type: object
                properties:
                  tweet_id:
                    type: string
                  summary:
                    type: string
                    description: Grok's answer (reasoning/tool-usage chunks stripped).
                  citations:
                    type: array
                    description: Web sources Grok used.
                    items:
                      type: object
                  model:
                    type: string
                  conversation_id:
                    type: string
                  tickers:
                    type: array
                    description: >-
                      Present only with suggest — extracted/proposed $TICKER
                      symbols.
                    items:
                      type: string
        '503':
          description: No Grok-capable account available
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api_key
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
    BearerAuth:
      type: http
      scheme: bearer

````