---
title: "List public X profile posts"
method: GET
path: "/x/profile/{username}/posts"
tags: ["X"]
---

# List public X profile posts

`GET /x/profile/{username}/posts`

## Request

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

Returns posts present in the first public profile page payload for an X username. The endpoint does not paginate replies, media-only tabs, or search results.

## Path parameters

- `username` string, required

## Query parameters

- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped profile posts payload

- XProfilePostsResponseDoc
  - `code` integer
  - `data` XProfilePosts
    - `count` integer
    - `posts` 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
    - `url` string
    - `username` string
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: Profile 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)