# X (Twitter) Tweets API Reference Canonical: https://monsterapi.co/docs/api/x-twitter-tweets Read the X (Twitter) Tweets 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): 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 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 ' ```