X community media tab API: photos & video posts

{
  "tweets": [],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

communities

{id}

media

X community media tab API: photos & video posts

curl --request GET \
  --url https://xquik.com/api/v1/x/communities/{id}/media

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/communities/{id}/media"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "tweets": [
    {
      "id": "<string>",
      "text": "<string>",
      "type": "<string>",
      "createdAt": "<string>",
      "isNoteTweet": true,
      "isPinned": true,
      "likeCount": 123,
      "retweetCount": 123,
      "replyCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "bookmarkCount": 123,
      "url": "<string>",
      "lang": "<string>",
      "isReply": true,
      "inReplyToId": "<string>",
      "inReplyToUserId": "<string>",
      "inReplyToUsername": "<string>",
      "conversationId": "<string>",
      "source": "<string>",
      "displayTextRange": [
        123
      ],
      "isLimitedReply": true,
      "isQuoteStatus": true,
      "isRetweet": true,
      "entities": {},
      "contentDisclosure": {},
      "author": {},
      "media": [
        {}
      ],
      "quoted_tweet": {},
      "retweeted_tweet": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

string

Filter to posts from this username. The @ prefix is optional.

string

Filter to replies directed to this username.

string

Filter to posts that mention this username.

string

Only include posts with this language code.

string

Include posts created on or after this date or timestamp.

string

Include posts up to this date or timestamp. A date is a UTC day, inclusive, so its own posts count.

string

Use images, videos, gifs, media, links, or none.

integer

Require this minimum like count.

integer

Require this minimum repost count.

integer

Require this minimum reply count.

integer

Require this minimum quote count.

integer

Require this minimum view count.

integer

Require this minimum bookmark count.

integer

Allow this maximum like count. Missing counts pass.

integer

Allow this maximum repost count. Missing counts pass.

integer

Allow this maximum reply count. Missing counts pass.

integer

Allow this maximum quote count. Missing counts pass.

boolean

When true, only return posts from Blue-verified authors.

boolean

When true, only return posts from verified authors.

string

Use include, exclude, or only for replies. This setting overrides includeReplies when the endpoint supports both.

string

Use include, exclude, or only for reposts.

string

Match this literal phrase, including any hyphens.

string

Exclude comma-separated or whitespace-separated terms.

string

Require at least 1 comma-separated or whitespace-separated term.

string

Match these hashtags. Separate values with commas or spaces.

string

Match these cashtags. Separate values with commas or spaces.

string

Use include, exclude, or only for quote posts.

string

URL substring or domain that must appear in tweet URL entities.

string

Filter to tweets in this conversation thread.

string

Only include replies to this tweet ID.

string

Filter to quote tweets of this tweet ID.

string

Filter to retweets of this tweet ID.

string

Return Tweets whose IDs exceed this ID.

string

Return Tweets at or below this ID.

boolean

When true, only return native reposts.

string

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 from $0.00012/credit

curl https://xquik.com/api/v1/x/communities/1472105760389668865/media \
  -H "x-api-key: xq_your_api_key_here" | jq

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`);
}

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

string

required

Community ID (numeric string).

Query parameters

string

Pagination cursor from a previous response. Omit for the first page.

number

Upper bound for tweets per page. Range: 1-100. Default: 20.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Media tweets of the Community, newest first. Tweet object fields.

string

Tweet ID.

string

Contains the complete Tweet text.

string

Classifies the Tweet when X returns a type.

string

ISO 8601 creation timestamp.

boolean

Whether this is a Note Tweet. Omitted if unavailable.

boolean

Whether the author pinned this post to their profile. Omitted if unavailable.

number

Reports the number of likes when available.

number

Reports the number of reposts when available.

number

Reports the number of replies when available.

number

Reports the number of quotes when available.

number

Reports the number of views when available.

number

Reports the number of bookmarks when available.

string

Permalink URL on X. Omitted if unavailable.

string

Reports the Tweet language code when available.

boolean

Whether the tweet is a reply. Omitted if unavailable.

string

Tweet ID being replied to. Omitted if not a reply.

string

Identifies the replied-to user when available.

string

Reports the replied-to username when available.

string

Conversation thread ID. Omitted if unavailable.

string

Client used to post the tweet. Omitted if unavailable.

number[]

Start and end offsets for rendered tweet text. Omitted if unavailable.

boolean

Whether replies are limited. Omitted if unavailable.

boolean

Whether this tweet quotes another tweet. Omitted if unavailable.

boolean

Whether this row is a retweet. text carries the original post in full.

object

Parsed entities. Omitted if unavailable.

object

Returns paid-promotion and AI-generated-media labels when available. Includes advertising.isPaidPromotion and aiGenerated.hasAiGeneratedMedia.

object

Tweet author profile. Omitted if unavailable. Author object fields.

string

Author user ID.

string

Author X username.

string

Author display name.

number

Reports the author’s follower count when available.

boolean

Whether the author is verified. Omitted if unavailable.

string

Profile picture URL. Omitted if unavailable.

object[]

Lists media items attached to the Tweet. Omitted when none exist. Media object fields.

string

Provides the direct media URL.

object[]

Lists available video renditions and playback details. Omitted for images.

string

Identifies the attached media type.

string

Shortened URL from the tweet text.

object

Embedded quoted tweet. Omitted if not a quote tweet.

object

Original retweeted tweet. Omitted if not a retweet.

boolean

Whether more results are available.

string

Cursor for the next page. Pass as the cursor query parameter.

{
  "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

{ "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.

{ "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

{ "error": "not_found" }

Xquik could not resolve the Community. Check the Community ID.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

503 Service busy

{ "error": "x_api_unavailable" }

Xquik is busy. Wait for Retry-After, then retry. The request costs nothing.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

The request exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "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 reads every post of the Community.

{
  "tweets": [],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

X community media tab API: photos & video posts

curl --request GET \
  --url https://xquik.com/api/v1/x/communities/{id}/media

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/communities/{id}/media"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "tweets": [
    {
      "id": "<string>",
      "text": "<string>",
      "type": "<string>",
      "createdAt": "<string>",
      "isNoteTweet": true,
      "isPinned": true,
      "likeCount": 123,
      "retweetCount": 123,
      "replyCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "bookmarkCount": 123,
      "url": "<string>",
      "lang": "<string>",
      "isReply": true,
      "inReplyToId": "<string>",
      "inReplyToUserId": "<string>",
      "inReplyToUsername": "<string>",
      "conversationId": "<string>",
      "source": "<string>",
      "displayTextRange": [
        123
      ],
      "isLimitedReply": true,
      "isQuoteStatus": true,
      "isRetweet": true,
      "entities": {},
      "contentDisclosure": {},
      "author": {},
      "media": [
        {}
      ],
      "quoted_tweet": {},
      "retweeted_tweet": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

X community media tab API: photos & video posts

Media tab or all posts?

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid community ID

401 Unauthenticated

402 Payment required

404 Community not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

X Community media questions

Which posts does the Media tab hold?

Can I filter the media posts?

Does this replace X’s official API?

​Media tab or all posts?

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid community ID

​401 Unauthenticated

​402 Payment required

​404 Community not found

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​X Community media questions

​Which posts does the Media tab hold?

​Can I filter the media posts?

​Does this replace X’s official API?

Media tab or all posts?

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid community ID

401 Unauthenticated

402 Payment required

404 Community not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

X Community media questions

Which posts does the Media tab hold?

Can I filter the media posts?

Does this replace X’s official API?