---
title: "Retrieve public posts from a Threads profile"
method: GET
path: "/threads/profile/{username}/posts"
tags: ["Threads"]
---

# Retrieve public posts from a Threads profile

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

## Request

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

Lists public posts from the profile's Threads tab by `username`. Each item has its code, URL, text, creation time, image and video URLs, like, reply, repost and quote counts, reply flag and author. When `has_more` is true, pass `next_cursor` unchanged as `cursor` to fetch the next page; `pagination_limited` is true if Threads withholds a usable cursor.

## Path parameters

- `username` string, required

## Query parameters

- `cursor` string

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped profile posts payload

- ThreadsProfilePostsResponseDoc
  - `code` integer
  - `data` ThreadsProfilePostsResult
    - `has_more` boolean
    - `items` ThreadsThread[]
      - `author` ThreadsAuthor
        - `id` string: Threads user ID of the author.
        - `name` string: Display name of the author.
        - `username` string: Threads username of the author.
      - `code` string
      - `created_at` string: Time the thread was posted, in UTC (RFC 3339).
      - `id` string: Threads post ID.
      - `image_urls` string[]: URLs of the images attached to the thread.
      - `is_reply` boolean: Whether the thread is a reply to another thread.
      - `like_count` integer: Number of likes on the thread.
      - `quote_count` integer: Number of times the thread was quoted.
      - `reply_count` integer: Number of replies to the thread.
      - `reply_to` string: Username of the account this thread replies to.
      - `repost_count` integer: Number of times the thread was reposted.
      - `text` string: Text of the thread.
      - `topic` ThreadsTopic
        - `community_emoji` string: Community reaction emoji, when present on a post tag.
        - `community_favicon_url` string: Community icon URL, when present.
        - `display_name` string: Topic label shown in Threads.
        - `id` string: Numeric Threads topic tag identifier.
        - `is_community` boolean: Whether Threads identifies this topic as a community.
        - `name` string: Canonical topic query returned on profile topic lists.
        - `search_query` string: Query to pair with ID when calling the topic search endpoint.
        - `tag_cluster_name` string: Topic cluster or category label, when present.
      - `url` string: URL of the thread on Threads.
      - `video_urls` string[]: URLs of the videos attached to the thread.
    - `next_cursor` string: Cursor to pass to fetch the next page when Threads provides one.
    - `pagination_limited` boolean: True when Threads reports more posts but does not provide a usable cursor.
    - `username` string
  - `msg` string

## Other responses

- `400`: Invalid username or cursor
- `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/028417aa35bb?raw)