> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xquik.com/llms.txt
> Use this file to discover all available pages before exploring further.
# X community media tab API: photos & video posts
> Export the posts on an X (Twitter) Community's Media tab, newest first, with authors, text, counts, photos, and videos. Filter them like posts. 1 credit each.
For the complete documentation index, see llms.txt.
Filter to posts from this username. The `@` prefix is optional.
Filter to replies directed to this username.
Filter to posts that mention this username.
Only include posts with this language code.
Include posts created on or after this date or timestamp.
Include posts up to this date or timestamp. A date is a UTC day, inclusive, so its own posts count.
Use `images`, `videos`, `gifs`, `media`, `links`, or `none`.
Require this minimum like count.
Require this minimum repost count.
Require this minimum reply count.
Require this minimum quote count.
Require this minimum view count.
Require this minimum bookmark count.
Allow this maximum like count. Missing counts pass.
Allow this maximum repost count. Missing counts pass.
Allow this maximum reply count. Missing counts pass.
Allow this maximum quote count. Missing counts pass.
When `true`, only return posts from Blue-verified authors.
When `true`, only return posts from verified authors.
Use `include`, `exclude`, or `only` for replies.
This setting overrides `includeReplies` when the endpoint supports both.
Use `include`, `exclude`, or `only` for reposts.
Match this literal phrase, including any hyphens.
Exclude comma-separated or whitespace-separated terms.
Require at least 1 comma-separated or whitespace-separated term.
Match these hashtags. Separate values with commas or spaces.
Match these cashtags. Separate values with commas or spaces.
Use `include`, `exclude`, or `only` for quote posts.
URL substring or domain that must appear in tweet URL entities.
Filter to tweets in this conversation thread.
Only include replies to this tweet ID.
Filter to quote tweets of this tweet ID.
Filter to retweets of this tweet ID.
Return Tweets whose IDs exceed this ID.
Return Tweets at or below this ID.
When `true`, only return native reposts.
Match Tweets from this recent window, such as `90m` or `7d`. Use a whole number & `s`, `m`, `h` or `d`.
**1 credit per tweet returned** · [All plans](https://xquik.com/#pricing) from \$0.00012/credit
```bash cURL theme={null}
curl https://xquik.com/api/v1/x/communities/1472105760389668865/media \
-H "x-api-key: xq_your_api_key_here" | jq
```
```javascript Node.js theme={null}
const response = await fetch("https://xquik.com/api/v1/x/communities/1472105760389668865/media", {
headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
for (const tweet of data.tweets) {
const urls = (tweet.media ?? []).map((item) => item.mediaUrl).join(" ");
process.stdout.write(`${tweet.id} ${urls}\n`);
}
```
```python Python theme={null}
import requests
response = requests.get(
"https://xquik.com/api/v1/x/communities/1472105760389668865/media",
headers={"x-api-key": "xq_your_api_key_here"},
)
for tweet in response.json()["tweets"]:
urls = [item["mediaUrl"] for item in tweet.get("media", [])]
print(tweet["id"], " ".join(urls))
```
Use `GET /x/communities/{id}/media` to export the posts on a Community's Media tab.
Each post has a photo or a video. Rows come newest first, like the tab on x.com.
Each tweet costs 1 credit. Filters run before billing, so filtered-out rows cost nothing.
## Media tab or all posts?
| Need | Route | Rows returned |
| - | - | - |
| Photo & video posts only | `/x/communities/{id}/media` | Media posts, newest first. |
| Every post of the Community | `/x/communities/{id}/tweets` | All posts, newest first or Top. |
Follow `next_cursor` until `has_next_page` is `false` for the whole tab.
## Path parameters
Community ID (numeric string).
## Query parameters
Pagination cursor from a previous response. Omit for the first page.
Upper bound for tweets per page. Range: 1-100. Default: `20`.
## Headers
Full account key. Sessions and OAuth also work.
`Bearer xq_your_guest_key_here` for `paid_reads`.
## Response
### 200 OK
Media tweets of the Community, newest first.
**Tweet object fields.**
Tweet ID.
Contains the complete Tweet text.
Classifies the Tweet when X returns a type.
ISO 8601 creation timestamp.
Whether this is a Note Tweet. Omitted if unavailable.
Whether the author pinned this post to their profile. Omitted if unavailable.
Reports the number of likes when available.
Reports the number of reposts when available.
Reports the number of replies when available.
Reports the number of quotes when available.
Reports the number of views when available.
Reports the number of bookmarks when available.
Permalink URL on X. Omitted if unavailable.
Reports the Tweet language code when available.
Whether the tweet is a reply. Omitted if unavailable.
Tweet ID being replied to. Omitted if not a reply.
Identifies the replied-to user when available.
Reports the replied-to username when available.
Conversation thread ID. Omitted if unavailable.
Client used to post the tweet. Omitted if unavailable.
Start and end offsets for rendered tweet text. Omitted if unavailable.
Whether replies are limited. Omitted if unavailable.
Whether this tweet quotes another tweet. Omitted if unavailable.
Whether this row is a retweet. `text` carries the original post in full.
Parsed entities. Omitted if unavailable.
Returns paid-promotion and AI-generated-media labels when available. Includes `advertising.isPaidPromotion` and `aiGenerated.hasAiGeneratedMedia`.
Tweet author profile. Omitted if unavailable.
**Author object fields.**
Author user ID.
Author X username.
Author display name.
Reports the author's follower count when available.
Whether the author is verified. Omitted if unavailable.
Profile picture URL. Omitted if unavailable.
Lists media items attached to the Tweet. Omitted when none exist.
**Media object fields.**
Provides the direct media URL.
Lists available video renditions and playback details. Omitted for images.
Identifies the attached media type.
Shortened URL from the tweet text.
Embedded quoted tweet. Omitted if not a quote tweet.
Original retweeted tweet. Omitted if not a retweet.
Whether more results are available.
Cursor for the next page. Pass as the `cursor` query parameter.
```json theme={null}
{
"tweets": [
{
"id": "1893456789012345678",
"text": "Community post content",
"createdAt": "2026-02-24T10:00:00.000Z",
"likeCount": 150,
"retweetCount": 42,
"replyCount": 10,
"viewCount": 12400,
"author": {
"id": "987654321",
"username": "username",
"name": "Xquik",
"followers": 12400,
"verified": true,
"profilePicture": "https://pbs.twimg.com/profile_images/example.jpg"
}
}
],
"has_next_page": true,
"next_cursor": "DAACCgACGE..."
}
```
### 400 Invalid community ID
```json theme={null}
{ "error": "invalid_community_id" }
```
The community ID is empty or invalid.
### 401 Unauthenticated
Anonymous requests get `WWW-Authenticate: Bearer` and a guest wallet checkout action. This is not a Payment challenge.
```json theme={null}
{ "error": "unauthenticated" }
```
Missing or invalid API key.
### 402 Payment required
Account keys get account options. Guest keys get guest top-up only.
No checkout starts automatically. Confirm any payment action.
### 404 Community not found
```json theme={null}
{ "error": "not_found" }
```
Xquik could not resolve the Community. Check the Community ID.
### 502 X API unavailable
```json theme={null}
{ "error": "x_api_unavailable" }
```
The read service returned an error. Retry after a short delay.
### 503 Service busy
```json theme={null}
{ "error": "x_api_unavailable" }
```
Xquik is busy. Wait for `Retry-After`, then retry. The request costs nothing.
### 429 Rate limit exceeded
```json theme={null}
{ "error": "rate_limit_exceeded", "retryAfter": 60 }
```
The request exceeded your tier rate limit. Wait for the `Retry-After` header before retrying.
### 424 Dependency failed
```json theme={null}
{ "error": "x_api_unavailable" }
```
The read service was unavailable. Retry after a short delay.
## X Community media questions
### Which posts does the Media tab hold?
The Community's posts that carry a photo or a video, newest first.
### Can I filter the media posts?
Yes. The tweet filters of Community tweets work here too, such as `minLikes` or `mediaType`.
### Does this replace X's official API?
No. This page documents Xquik, an independent third-party service.
It does not document X's official API.
**Next steps.** [Community tweets](/api-reference/x/community-tweets) reads every post of the Community.
* Profiles: [Search users](/api-reference/x/search-users) · [Search autocomplete](/api-reference/x/search-autocomplete) · [Get user](/api-reference/x/twitter-profile-lookup) · [Batch users](/api-reference/x/batch-users)
* Followers: [Followers](/api-reference/x/followers) · [Following](/api-reference/x/following) · [Follower IDs](/api-reference/x/follower-ids) · [Following IDs](/api-reference/x/following-ids) · [Creator subscriptions](/api-reference/x/user-subscriptions) · [Affiliates](/api-reference/x/user-affiliates) · [Similar accounts](/api-reference/x/user-similar) · [Verified followers](/api-reference/x/verified-followers) · [Followers you know](/api-reference/x/followers-you-know) · [Check follower](/api-reference/x/check-follower)
* Lists: [Search lists](/api-reference/x/search-lists) · [User lists](/api-reference/x/user-lists) · [List memberships](/api-reference/x/user-list-memberships) · [List members](/api-reference/x/list-members) · [List followers](/api-reference/x/list-followers)
* Communities: [Find](/api-reference/x/community-find) · [Popular](/api-reference/x/community-popular) · [Topics](/api-reference/x/community-topics) · [Suggested](/api-reference/x/community-suggested) · [Details](/api-reference/x/community-info) · [Members](/api-reference/x/community-members) · [Moderators](/api-reference/x/community-moderators) · [Timeline](/api-reference/x/community-tweets) · [Media](/api-reference/x/community-media) · [Keyword search](/api-reference/x/community-search)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.