# X (Twitter) API Reference Canonical: https://monsterapi.co/docs/api/twitter Read the X (Twitter) API 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 ` 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 ' ``` --- # 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 ` 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 ' ``` --- # 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 ` 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 ' ``` --- # X (Twitter): List members `GET /twitter/api/list/{id}/members` Documentation: https://monsterapi.co/docs/api/twitter#list-members Operation ID: `twitter_list_members` Returns a page of accounts on one list by numeric identifier. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required list identifier from its X list URL. Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /list/{id}/members](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /list/{id}/members. 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 accounts: 1 to 100, default 40. The response may contain more or fewer. ## Responses - 200: Page of accounts; a page without accounts 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 list, 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/list/{id}/members' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): List details and post preview `GET /twitter/api/list/{id}/timeline/syndication` Documentation: https://monsterapi.co/docs/api/twitter#list-details-and-post-preview Operation ID: `twitter_list_timeline_syndication` Returns a public list's name, member count, owner and a preview of posts from its accounts by numeric identifier. Has no pagination cursor. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required list identifier from its X list URL. Decimal digits from 1 to 9223372036854775807, no leading zero. ## Responses - 200: The list and the posts of its accounts - 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: No such list, or no posts are available - 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/list/{id}/timeline/syndication' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): List posts `GET /twitter/api/list/{id}/tweets` Documentation: https://monsterapi.co/docs/api/twitter#list-posts Operation ID: `twitter_list_tweets` Returns a page of posts from accounts on one list by numeric identifier, newest first. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required list identifier from its X list URL. Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /list/{id}/tweets](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /list/{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 list, 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/list/{id}/tweets' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Live broadcasts and video `GET /twitter/api/live` Documentation: https://monsterapi.co/docs/api/twitter#live-broadcasts-and-video Operation ID: `twitter_live_feed` Returns a page of live broadcasts and video posts. Later pages may contain recent videos already present on an earlier page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /live](https://monsterapi.co/docs/twitter#live-video) unchanged as `cursor` to GET /live. 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: 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: X answered that the feed is not there, 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/live' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Embeddable content `GET /twitter/api/oembed` Documentation: https://monsterapi.co/docs/api/twitter#embeddable-content Operation ID: `twitter_oembed` Returns embeddable content and metadata for an HTTPS post, profile or list URL on x.com or twitter.com. Post responses include author metadata. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): https URL on `x.com` or `twitter.com`, including `www.` and `mobile.`: `/{handle}/status/{id}`, `/{handle}`, `/i/lists/{id}` or `/{handle}/lists/{slug}`. Handles: 1 to 15 letters, digits or underscores. Both post and numeric list IDs: decimal digits from 1 to 9223372036854775807, no leading zero. ## Responses - 200: Post markup and author metadata, or profile/list timeline markup, under oEmbed names - 400: URL missing, malformed or outside the accepted host, scheme, handle or identifier formats 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 found no embeddable resource at this URL - 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/oembed' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Post search results `GET /twitter/api/search` Documentation: https://monsterapi.co/docs/api/twitter#post-search-results Operation ID: `twitter_search` Returns a page of posts matching a query and ranking. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Required search text: 1 to 256 Unicode letters, numbers, combining marks, punctuation, symbols or spaces, with a non-space character. Controls, line breaks and invisible formatting characters are not accepted. - `product` (query, optional): Optional ranking: Top, Latest, People, Photos or Videos; default Top. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /search](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /search. 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: Query missing or blank, a parameter outside the accepted set, or a cursor that cannot continue this search 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: X answered that the search is not there, or nothing matched and no cursor leads to a next page - 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/search' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Audio space details `GET /twitter/api/space/{id}` Documentation: https://monsterapi.co/docs/api/twitter#audio-space-details Operation ID: `twitter_space_detail` Returns one audio space by identifier, with its title, state, times, host and participants. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required space identifier from the `https://x.com/i/spaces/{id}` URL: 13 ASCII letters or digits. ## Responses - 200: The audio space with its participants - 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: X answered with the error of a suspended account Refused at the gateway: the API key is unknown or revoked - 404: No such space - 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/space/{id}' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Trending topics by place `GET /twitter/api/trends` Documentation: https://monsterapi.co/docs/api/twitter#trending-topics-by-place Operation ID: `twitter_trends` Returns trending topics for one place, including promoted topics, the place and the time of the list. Reports worldwide trends when woeid is omitted. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `woeid` (query, optional): Optional geographic identifier from `places[].woeid` in [GET /trends/locations](https://monsterapi.co/docs/twitter#trends-and-topics). Decimal digits from 1 to 4294967295, no leading zero; default 1 for worldwide trends. ## Responses - 200: Trends of the place - 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: No such place - 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/trends' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Trend locations `GET /twitter/api/trends/locations` Documentation: https://monsterapi.co/docs/api/twitter#trend-locations Operation ID: `twitter_trend_locations` Returns places with reported trends and their geographic identifiers. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs ## Responses - 200: Places that have trends - 400: #/components/responses/GatewayBadRequest - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: X answered that the list of places is not there - 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/trends/locations' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Popular topic posts `GET /twitter/api/trends/timeline` Documentation: https://monsterapi.co/docs/api/twitter#popular-topic-posts Operation ID: `twitter_trend_timeline` Returns a preview of popular posts for a topic tag. Has no search modes or limit parameter; continuation is available only when next_cursor is present. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `tag` (query, required): Required topic as written, 1 to 256 printable Unicode characters, not only spaces; excludes controls, invisible formatting characters and line or paragraph separators. URL-encode the query value, for example tag=%23bitcoin or tag=New%20York - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /trends/timeline](https://monsterapi.co/docs/twitter#trends-and-topics) unchanged as `cursor` to GET /trends/timeline. 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. ## Responses - 200: Guest preview; next_cursor is present only when X gave one - 400: Tag or cursor 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 - 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 topic preview is unreadable or empty without next_cursor; this does not establish that the topic 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/trends/timeline' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Post details `GET /twitter/api/tweet/{id}` Documentation: https://monsterapi.co/docs/api/twitter#post-details-3 Operation ID: `twitter_tweet_detail` Returns one post by numeric identifier, with its full text, author, attachments, references and counts. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required post identifier from its X status URL, or `posts[].id` in [GET /user/id/{rest_id}/tweets](https://monsterapi.co/docs/twitter#account-posts). Decimal digits from 1 to 9223372036854775807, no leading zero. ## Responses - 200: The post - 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: Post withheld or not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such post - 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/tweet/{id}' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Post and conversation preview `GET /twitter/api/tweet/{id}/render` Documentation: https://monsterapi.co/docs/api/twitter#post-and-conversation-preview Operation ID: `twitter_tweet_render` Returns one post, its preceding conversation posts and a sample of replies by numeric identifier. Has no pagination cursor. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required post identifier from its X status URL, or `posts[].id` in [GET /user/id/{rest_id}/tweets](https://monsterapi.co/docs/twitter#account-posts). Decimal digits from 1 to 9223372036854775807, no leading zero. ## Responses - 200: The post and its conversation - 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: Post withheld, or not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such post, or it was deleted - 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/tweet/{id}/render' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Post summary `GET /twitter/api/tweet/{id}/syndication` Documentation: https://monsterapi.co/docs/api/twitter#post-summary Operation ID: `twitter_tweet_syndication` Returns one post by numeric identifier, with its text, author, attachments and counts where supplied. Long text may be shortened. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required post identifier from its X status URL, or `posts[].id` in [GET /user/id/{rest_id}/tweets](https://monsterapi.co/docs/twitter#account-posts). Decimal digits from 1 to 9223372036854775807, no leading zero. ## Responses - 200: The post - 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: Post withheld Refused at the gateway: the API key is unknown or revoked - 404: No such post - 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/tweet/{id}/syndication' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Post conversation `GET /twitter/api/tweet/{id}/thread` Documentation: https://monsterapi.co/docs/api/twitter#post-conversation Operation ID: `twitter_tweet_thread` Returns a page of conversation posts around one post by numeric identifier. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Required post identifier from its X status URL, or `posts[].id` in [GET /user/id/{rest_id}/tweets](https://monsterapi.co/docs/twitter#account-posts). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /tweet/{id}/thread](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /tweet/{id}/thread. 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 post, 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/tweet/{id}/thread' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account followers `GET /twitter/api/user/id/{rest_id}/followers` Documentation: https://monsterapi.co/docs/api/twitter#account-followers Operation ID: `twitter_user_followers_by_id` Returns a page of accounts following one account by numeric identifier. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /user/id/{rest_id}/followers](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /user/id/{rest_id}/followers. 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 accounts: 1 to 100, default 40. The response may contain more or fewer. ## Responses - 200: Page of accounts; a page without accounts 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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, 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/user/id/{rest_id}/followers' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account following `GET /twitter/api/user/id/{rest_id}/following` Documentation: https://monsterapi.co/docs/api/twitter#account-following Operation ID: `twitter_user_following_by_id` Returns a page of accounts followed by one account by numeric identifier. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /user/id/{rest_id}/following](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /user/id/{rest_id}/following. 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 accounts: 1 to 100, default 40. The response may contain more or fewer. ## Responses - 200: Page of accounts; a page without accounts 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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, 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/user/id/{rest_id}/following' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account highlights `GET /twitter/api/user/id/{rest_id}/highlights` Documentation: https://monsterapi.co/docs/api/twitter#account-highlights Operation ID: `twitter_user_highlights_by_id` Returns a page of posts selected for one account's highlights by numeric identifier. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /user/id/{rest_id}/highlights](https://monsterapi.co/docs/twitter#account-posts) unchanged as `cursor` to GET /user/id/{rest_id}/highlights. 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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, 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/user/id/{rest_id}/highlights' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account liked posts `GET /twitter/api/user/id/{rest_id}/likes` Documentation: https://monsterapi.co/docs/api/twitter#account-liked-posts Operation ID: `twitter_user_likes_by_id` Returns a page of posts liked by one account by numeric identifier. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /user/id/{rest_id}/likes](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /user/id/{rest_id}/likes. 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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, 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/user/id/{rest_id}/likes' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account media posts `GET /twitter/api/user/id/{rest_id}/media` Documentation: https://monsterapi.co/docs/api/twitter#account-media-posts Operation ID: `twitter_user_media_by_id` Returns a page of media posts for one account by numeric identifier. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /user/id/{rest_id}/media](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /user/id/{rest_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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, 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/user/id/{rest_id}/media' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account posts and replies `GET /twitter/api/user/id/{rest_id}/replies` Documentation: https://monsterapi.co/docs/api/twitter#account-posts-and-replies Operation ID: `twitter_user_replies_by_id` Returns a page of posts, reposts and replies for one account by numeric identifier. Requires sign-in and is unavailable through the public guest API. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /user/id/{rest_id}/replies](https://monsterapi.co/docs/twitter#unavailable-endpoints) unchanged as `cursor` to GET /user/id/{rest_id}/replies. 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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, 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/user/id/{rest_id}/replies' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account post preview `GET /twitter/api/user/id/{rest_id}/timeline/syndication` Documentation: https://monsterapi.co/docs/api/twitter#account-post-preview Operation ID: `twitter_user_timeline_syndication_by_id` Returns an account's identifier, current handle and a preview of its posts by numeric identifier. Has no pagination cursor. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. ## Responses - 200: Posts of the account - 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: No such account - 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/user/id/{rest_id}/timeline/syndication' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account posts `GET /twitter/api/user/id/{rest_id}/tweets` Documentation: https://monsterapi.co/docs/api/twitter#account-posts-2 Operation ID: `twitter_user_tweets_by_id` Returns a page of posts and reposts for one account by numeric identifier, newest first. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `rest_id` (path, required): Required account identifier from `user.id` in [GET /user/{name}](https://monsterapi.co/docs/twitter#account-profiles). Decimal digits from 1 to 9223372036854775807, no leading zero. - `cursor` (query, optional): Optional continuation: send top-level `next_cursor` from [GET /user/id/{rest_id}/tweets](https://monsterapi.co/docs/twitter#account-posts) unchanged as `cursor` to GET /user/id/{rest_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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, 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/user/id/{rest_id}/tweets' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account profile by handle `GET /twitter/api/user/{name}` Documentation: https://monsterapi.co/docs/api/twitter#account-profile-by-handle Operation ID: `twitter_user_profile` Returns the public profile of one account by handle, with its identity, biography, images, verification and counts. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (path, required): Required handle without @: 1 to 15 ASCII letters, digits or underscores. ## Responses - 200: Profile of the account - 400: Handle 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: Account not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account - 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/user/{name}' \ -H 'Authorization: Bearer ' ``` --- # X (Twitter): Account profile and post preview `GET /twitter/api/user/{name}/timeline/render` Documentation: https://monsterapi.co/docs/api/twitter#account-profile-and-post-preview Operation ID: `twitter_user_timeline_render` Returns an account profile and a preview of its original posts by handle, with a pinned post first when present. Has no pagination cursor. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (path, required): Required handle without @: 1 to 15 ASCII letters, digits or underscores. ## Responses - 200: The account and its first posts - 400: Handle 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: Account or its posts not available anonymously Refused at the gateway: the API key is unknown or revoked - 404: No such account, or no posts are available - 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/user/{name}/timeline/render' \ -H 'Authorization: Bearer ' ```