WEB DATA

Twitter user timeline

Retrieve public posts and profile details from one Twitter account.

POSThttps://api.sukidata.com/v1/twitter

QUICKSTART

Make a request

Identify the account by username or numeric user ID. The default page contains up to 20 posts.

cURL

curl --request POST \
  --url https://api.sukidata.com/v1/twitter \
  --header "Authorization: Bearer $SUKIDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "Cloudflare",
    "max_results": 20
  }'

REQUEST BODY

Parameters

Provide exactly one of username or user_id.

usernamestring · one required

Twitter username with or without a leading @.

user_idstring · one required

Numeric Twitter user ID.

max_resultsinteger

Maximum posts returned in this page, from 1 to 100. The default is 20.

cursorstring

The opaque next_cursor value from the preceding response.

asyncboolean

Set to true to receive the search ID immediately and query the result later. Defaults to false.

View the complete Twitter schema in the API Reference

RESPONSE

Timeline result

A completed response contains the account, its posts, and a cursor when another page is available.

search_metadataRequest status, identifiers, timing, and result file links.

search_parametersAccount identifier and page settings used.

userPublic profile fields for the requested account.

tweetsReturned public posts, including text and available engagement details.

next_cursorOpaque value used to request the next page.

Asynchronous responsesIf search_metadata.status is Queued or Processing, query GET /v1/twitter/{search_id} using search_metadata.id.

BILLING

Credit usage

Twitter uses Web Data credits. Read X-Sukidata-Credits-Used for the final charge. See Web Data billing for rates and free responses.

Need help with a request? Email support@sukidata.com and include the X-Request-ID response header.