# X (Twitter) Community API Reference

Canonical: https://monsterapi.co/docs/api/x-twitter-community

Read the X (Twitter) Community reference. Review parameters, response fields, examples, and current credit prices.

OpenAPI specification: [X (Twitter)](https://monsterapi.co/docs/openapi/platforms/twitter.yaml).

---

Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request.

---

# X (Twitter): Community media posts

`GET /twitter/api/community/{id}/media`

Documentation: https://monsterapi.co/docs/api/twitter#community-media-posts

Operation ID: `twitter_community_media`

Returns a page of media posts for one public community by numeric identifier.

## Authentication

Send your billing API key in the `Authorization: Bearer <YOUR_API_KEY>` header. Your account login is separate.

## Inputs

- `id` (path, required): Required community identifier from its X community URL or `community.id` in [GET /community/{id}/render](https://monsterapi.co/docs/twitter#communities). Decimal digits from 1 to 9223372036854775807, no leading zero.

- `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /community/{id}/media](https://monsterapi.co/docs/twitter#communities) unchanged as `cursor` to GET /community/{id}/media. Up to 8,192 characters; base64/base64url decoding to at least five bytes, or two signed 64-bit decimal numbers separated by |. Omit for the first page.

- `limit` (query, optional): Optional requested number of posts: 1 to 100, default 40. The response may contain more or fewer.

## Responses

- 200: Page of posts; a page without posts carries the cursor of the next one

- 400: Identifier, cursor or limit outside the accepted set, or a cursor that cannot continue this list

Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields

- 401: #/components/responses/GatewayUnauthorized

- 402: #/components/responses/GatewayPaymentRequired

- 403: X answered with the error of a suspended account

Refused at the gateway: the API key is unknown or revoked

- 404: No such community, or it is not public, or an empty list without next_cursor

- 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused

Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do

- 409: #/components/responses/GatewayConflict

- 429: #/components/responses/GatewayTooManyRequests

- 500: The requested information could not be read; this does not establish that the object is absent

- 501: The requested information is unavailable without sign-in

- 503: Rate limit (`rate_limited`), temporary request failure (`upstream_error`), service capacity unavailable (`no_proxies`), too many concurrent requests (`overloaded`), or request temporarily unavailable (`upstream_stale`)

Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer

## Credits

Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call.

https://monsterapi.co/docs/pricing

## Request template

Replace path placeholders and add the required query parameters from the Inputs section before sending.

```shell

curl --get 'https://api.monsterapi.co/twitter/api/community/{id}/media' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# X (Twitter): Community details

`GET /twitter/api/community/{id}/render`

Documentation: https://monsterapi.co/docs/api/twitter#community-details

Operation ID: `twitter_community_render`

Returns a public community's metadata, rules, creator, banners and a sample of members by numeric identifier. The member sample has no continuation.

## Authentication

Send your billing API key in the `Authorization: Bearer <YOUR_API_KEY>` header. Your account login is separate.

## Inputs

- `id` (path, required): Required community identifier from its X community URL. Decimal digits from 1 to 9223372036854775807, no leading zero.

## Responses

- 200: The public community card

- 400: Identifier outside the accepted set

Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields

- 401: #/components/responses/GatewayUnauthorized

- 402: #/components/responses/GatewayPaymentRequired

- 403: #/components/responses/GatewayForbidden

- 404: X answered that the community does not exist

- 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused

Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do

- 409: #/components/responses/GatewayConflict

- 429: #/components/responses/GatewayTooManyRequests

- 500: The requested information could not be read; this does not establish that the object is absent

- 501: The requested information is unavailable without sign-in

- 503: Rate limit (`rate_limited`), temporary request failure (`upstream_error`), service capacity unavailable (`no_proxies`), or too many concurrent requests (`overloaded`)

Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer

## Credits

Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call.

https://monsterapi.co/docs/pricing

## Request template

Replace path placeholders and add the required query parameters from the Inputs section before sending.

```shell

curl --get 'https://api.monsterapi.co/twitter/api/community/{id}/render' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# X (Twitter): Community posts

`GET /twitter/api/community/{id}/tweets`

Documentation: https://monsterapi.co/docs/api/twitter#community-posts

Operation ID: `twitter_community_tweets`

Returns a page of posts for one public community by numeric identifier.

## Authentication

Send your billing API key in the `Authorization: Bearer <YOUR_API_KEY>` header. Your account login is separate.

## Inputs

- `id` (path, required): Required community identifier from its X community URL or `community.id` in [GET /community/{id}/render](https://monsterapi.co/docs/twitter#communities). Decimal digits from 1 to 9223372036854775807, no leading zero.

- `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /community/{id}/tweets](https://monsterapi.co/docs/twitter#communities) unchanged as `cursor` to GET /community/{id}/tweets. Up to 8,192 characters; base64/base64url decoding to at least five bytes, or two signed 64-bit decimal numbers separated by |. Omit for the first page.

- `limit` (query, optional): Optional requested number of posts: 1 to 100, default 40. The response may contain more or fewer.

## Responses

- 200: Page of posts; a page without posts carries the cursor of the next one

- 400: Identifier, cursor or limit outside the accepted set, or a cursor that cannot continue this list

Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields

- 401: #/components/responses/GatewayUnauthorized

- 402: #/components/responses/GatewayPaymentRequired

- 403: X answered with the error of a suspended account

Refused at the gateway: the API key is unknown or revoked

- 404: No such community, or it is not public, or an empty list without next_cursor

- 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused

Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do

- 409: #/components/responses/GatewayConflict

- 429: #/components/responses/GatewayTooManyRequests

- 500: The requested information could not be read; this does not establish that the object is absent

- 501: The requested information is unavailable without sign-in

- 503: Rate limit (`rate_limited`), temporary request failure (`upstream_error`), service capacity unavailable (`no_proxies`), too many concurrent requests (`overloaded`), or request temporarily unavailable (`upstream_stale`)

Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer

## Credits

Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call.

https://monsterapi.co/docs/pricing

## Request template

Replace path placeholders and add the required query parameters from the Inputs section before sending.

```shell

curl --get 'https://api.monsterapi.co/twitter/api/community/{id}/tweets' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```
