Write Actions

Media Status

Return the async processing state of a media_id from Upload Media, so a caller can verify readiness before attaching a video, GIF, or large-media id to a tweet. Runs as your own logged-in account. Billed at $0.0008 per call. Cost: $0.0008 per call.

get/media/status

Request

  • Base URL: https://api.twitterapis.com/twitter
  • URL: https://api.twitterapis.com/twitter/media/status
  • Auth: HTTP bearer

Query parameters

media_idstring required

Numeric media ID (as a string) returned by media/upload.

Example:1899999999999999999
fieldsstring

Comma-separated list of dotted field paths to keep in the response (one parameter, never repeated), applied to every object in the returned lists and to nested objects (for example fields=id,text,author.username; the list's own name may prefix a path, fields=tweets.id). A path prefix that lands on an array applies to each element (media.media_url_https). Pagination and envelope keys (next_cursor, cursor, has_more, count, partial, error, message, reason) are always kept. Unknown paths are ignored; up to 50 paths of up to 6 segments. Projection never changes status codes or billing, and applies to data reads only: account, feedback, session status, monitor (other than deliveries), webhook and stream-compat reads return their bodies unchanged.

compact'1'

Set to 1 (or true) to apply the built-in compact preset: ids, url, text, created_at, lang, the engagement counts, the is_retweet/is_reply/is_quote flags, conversation ids, the author's id/username/name/followers_count/verification, and the quoted or retweeted tweet's id/url/author username. The preset trims what it recognises and leaves alone what it would empty, so it never turns a body into {}. Combine with fields to add paths on top of the preset. Typically cuts a tweet page by 70 to 90 percent for LLM tool callers.

Response

Check the async processing state of an uploaded media_id.

media_idstring

Echo of the media_id you queried.

statestring

Processing state: pending, in_progress, succeeded, or failed.

check_after_secsinteger

Seconds to wait before polling again while the state is pending or in_progress; 0 once processing has finished.

progress_percentinteger

Percentage of processing completed, from 0 to 100.

errorstring

Failure reason, present only when state is failed; omitted otherwise.

Changes

No recorded changes to this operation across all 1 revision of this API.