Social

X/Twitter Read

Read live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media. Pay per call in USDC — no API key, no signup; failed calls are never charged.

post/api/tools/x_read

Request

  • Base URL: https://twitr.sh
  • URL: https://twitr.sh/api/tools/x_read
  • Auth: none declared

Request body

resource'get-tweet' | 'get-user' | 'batch-tweets' | 'batch-users' | 'check-follower' | 'trends' | 'article' | 'followers-you-know' | 'download-media' required

Which read operation to run.

idstring

Tweet ID, user ID, or username (depends on resource).

idsstring[]

batch-tweets|batch-users: up to 100 tweet IDs or user IDs/usernames.

sourcestring

check-follower: source username.

targetstring

check-follower: target username.

woeidinteger

trends: region WOEID (default 1 = worldwide).

countinteger

trends: number of trends to return.

resultsLimitinteger

Mandatory for followers-you-know: max results, billed per result.

Response

Result dataset.

itemsobject[] required

Array of returned items. Shape varies per tool — see each tool's documentation.

runIdstring

Run ID for debugging/audit.

durationinteger

Run duration in seconds.

Changes

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