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

# Retrieve public media posts from a Threads profile

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

## Request

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

Returns the first public page shown on a profile's Media tab. Items include image and video URLs, including carousel attachments, plus post and topic metadata. The logged-out page exposes no continuation cursor or media-type filter; `pagination_limited` reports when additional results are gated by login or lack a supported cursor.

## Path parameters

- `username` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped profile media payload

- ThreadsProfileMediaResponseDoc
  - `code` integer
  - `data` ThreadsProfileMediaResult
    - `has_more` boolean: Whether Threads reports more public media beyond this page.
    - `items` ThreadsThread[]: Public media posts, including image and video attachments when available.
      - `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.
    - `pagination_limited` boolean: True when Threads gates additional media behind login or exposes no supported continuation cursor.
    - `username` string: Profile whose public Media tab was read.
  - `msg` string

## Other responses

- `400`: Invalid username
- `404`: Profile not found
- `503`: Upstream error or parser drift

## Changes

- **2026-10-19** `0497899e2016`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crawlora/apis/crawlora-api/changes/threads/profile/:username/media/get.md)

---

[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)