---
title: "Retrieve an X post"
method: GET
path: "/x/post/{id}"
tags: ["X"]
---

# Retrieve an X post

`GET /x/post/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/x/post/{id}`
- Auth: API key in header `x-api-key`

Returns a public X post by numeric post id, including author, text, visible metrics, and a quoted post preview when present.

## Path parameters

- `id` string, required

## Query parameters

- `username` string

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped post payload

- XPostResponseDoc
  - `code` integer
  - `data` XPost
    - `author` XUser
      - `avatar_url` string
      - `banner_url` string
      - `id` string
      - `is_blue_verified` boolean
      - `is_protected` boolean
      - `name` string
      - `url` string
      - `username` string
    - `created_at` string
    - `id` string
    - `metrics` XMetrics
      - `bookmarks` integer
      - `likes` integer
      - `replies` integer
      - `reposts` integer
      - `views` integer
    - `quoted` XPostQuote
      - `author` XUser
        - `avatar_url` string
        - `banner_url` string
        - `id` string
        - `is_blue_verified` boolean
        - `is_protected` boolean
        - `name` string
        - `url` string
        - `username` string
      - `created_at` string
      - `id` string
      - `text` string
      - `url` string
    - `text` string
    - `url` string
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: Post not found
- `503`: Upstream error or parser drift

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)
