/v1/twitter/user-tweets

GET

User Tweets

Get up to 100 popular tweets from a user's public profile, not their latest tweets.

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`handle` Twitter handle	query / required	`string`
`trim` Set true for a trimmed response.	query / optional	`boolean`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/twitter/user-tweets?handle=YOUR_HANDLE' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/twitter/user-tweets?handle=YOUR_HANDLE", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/twitter/user-tweets?handle=YOUR_HANDLE",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

tweetsrequired

array

Array items

object

__typenameoptional

string

rest_idrequired

string

coreoptional

object

user_resultsrequired

object

resultrequired

object

__typenamerequired

string

idrequired

string

rest_idrequired

string

affiliates_highlighted_labelrequired

object

labeloptional

object

badgerequired

object

urlrequired

string

descriptionrequired

string

urlrequired

object

urlrequired

string

urlTyperequired

string

userLabelDisplayTyperequired

string

userLabelTyperequired

string

is_blue_verifiedrequired

boolean

profile_image_shaperequired

string

legacyrequired

object

created_atrequired

string

default_profilerequired

boolean

default_profile_imagerequired

boolean

descriptionrequired

string

entitiesrequired

object

descriptionrequired

object

urlsrequired

array

Array items

object

display_urlrequired

string

expanded_urlrequired

string

urlrequired

string

indicesrequired

array

Array items

integer

urloptional

object

urlsrequired

array

Array items

object

display_urlrequired

string

expanded_urlrequired

string

urlrequired

string

indicesrequired

array

Array items

integer

fast_followers_countrequired

integer

favourites_countrequired

integer

followers_countrequired

integer

friends_countrequired

integer

has_custom_timelinesrequired

boolean

is_translatorrequired

boolean

listed_countrequired

integer

locationrequired

string

media_countrequired

integer

namerequired

string

normal_followers_countrequired

integer

pinned_tweet_ids_strrequired

array

Array items

string

possibly_sensitiverequired

boolean

profile_banner_urlrequired

string

profile_image_url_httpsrequired

string

profile_interstitial_typerequired

string

screen_namerequired

string

statuses_countrequired

integer

translator_typerequired

string

urlrequired

string

verifiedrequired

boolean

withheld_in_countriesoptional

array

blocked_byoptional

boolean

blockingoptional

boolean

can_dmoptional

boolean

can_media_tagoptional

boolean

follow_request_sentoptional

boolean

followed_byoptional

boolean

followingoptional

boolean

mutingoptional

boolean

needs_phone_verificationoptional

boolean

notificationsoptional

boolean

protectedoptional

boolean

time_zoneoptional

string

utc_offsetoptional

integer

withheld_descriptionoptional

string

withheld_scopeoptional

string

professionalrequired

object

rest_idrequired

string

professional_typerequired

string

categoryrequired

array

tipjar_settingsrequired

object

is_enabledrequired

boolean

bandcamp_handlerequired

string

bitcoin_handlerequired

string

cash_app_handlerequired

string

ethereum_handlerequired

string

gofundme_handlerequired

string

patreon_handlerequired

string

pay_pal_handlerequired

string

venmo_handlerequired

string

has_graduated_accessoptional

boolean

super_follow_eligibleoptional

boolean

super_followed_byoptional

boolean

super_followingoptional

boolean

unmention_dataoptional

object

edit_controloptional

object

edit_tweet_idsrequired

array

Array items

string

editable_until_msecsrequired

string

is_edit_eligiblerequired

boolean

edits_remainingrequired

string

is_translatableoptional

boolean

viewsrequired

object

countoptional

string

staterequired

string

sourceoptional

string

legacyrequired

object

bookmark_countrequired

integer

bookmarkedrequired

boolean

created_atrequired

string

conversation_id_strrequired

string

display_text_rangerequired

array

Array items

integer

entitiesrequired

object

hashtagsoptional

array

mediaoptional

array

Array items

object

display_urlrequired

string

expanded_urlrequired

string

id_strrequired

string

indicesrequired

array

Array items

integer

media_keyrequired

string

media_url_httpsrequired

string

typerequired

string

urlrequired

string

ext_media_availabilityrequired

object

statusrequired

string

featuresrequired

object

largerequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

mediumrequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

smallrequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

origrequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

sizesrequired

object

largerequired

object

hrequired

integer

wrequired

integer

resizerequired

string

mediumrequired

object

hrequired

integer

wrequired

integer

resizerequired

string

smallrequired

object

hrequired

integer

wrequired

integer

resizerequired

string

thumbrequired

object

hrequired

integer

wrequired

integer

resizerequired

string

original_inforequired

object

heightrequired

integer

widthrequired

integer

focus_rectsrequired

array

Array items

object

xrequired

integer

yrequired

integer

wrequired

integer

hrequired

integer

media_resultsrequired

object

resultrequired

object

media_keyrequired

string

symbolsoptional

array

timestampsoptional

array

urlsoptional

array

user_mentionsoptional

array

extended_entitiesoptional

object

mediarequired

array

Array items

object

display_urlrequired

string

expanded_urlrequired

string

id_strrequired

string

indicesrequired

array

Array items

integer

media_keyrequired

string

media_url_httpsrequired

string

typerequired

string

urlrequired

string

ext_media_availabilityrequired

object

statusrequired

string

featuresrequired

object

largerequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

mediumrequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

smallrequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

origrequired

object

facesrequired

array

Array items

object

hrequired

integer

wrequired

integer

xrequired

integer

yrequired

integer

sizesrequired

object

largerequired

object

hrequired

integer

wrequired

integer

resizerequired

string

mediumrequired

object

hrequired

integer

wrequired

integer

resizerequired

string

smallrequired

object

hrequired

integer

wrequired

integer

resizerequired

string

thumbrequired

object

hrequired

integer

wrequired

integer

resizerequired

string

original_inforequired

object

heightrequired

integer

widthrequired

integer

focus_rectsrequired

array

Array items

object

xrequired

integer

yrequired

integer

wrequired

integer

hrequired

integer

media_resultsrequired

object

resultrequired

object

media_keyrequired

string

favorite_countrequired

integer

favoritedrequired

boolean

full_textrequired

string

is_quote_statusrequired

boolean

langrequired

string

possibly_sensitiveoptional

boolean

possibly_sensitive_editableoptional

boolean

quote_countrequired

integer

reply_countrequired

integer

retweet_countrequired

integer

retweetedrequired

boolean

user_id_strrequired

string

id_strrequired

string

quoted_status_id_stroptional

string

quoted_status_permalinkoptional

object

displayrequired

string

expandedrequired

string

urlrequired

string

quick_promote_eligibilityoptional

object

eligibilityrequired

string

urlrequired

string

quoted_status_resultoptional

object

resultrequired

object

__typenamerequired

string

corerequired

object

user_resultsrequired

object

resultrequired

object

__typenamerequired

string

affiliates_highlighted_labelrequired

object

labelrequired

object

badgerequired

object

urlrequired

string

descriptionrequired

string

urlrequired

object

urlrequired

string

urlTyperequired

string

userLabelDisplayTyperequired

string

userLabelTyperequired

string

has_graduated_accessrequired

boolean

idrequired

string

is_blue_verifiedrequired

boolean

legacyrequired

object

blocked_byrequired

boolean

blockingrequired

boolean

can_dmrequired

boolean

can_media_tagrequired

boolean

created_atrequired

string

default_profilerequired

boolean

default_profile_imagerequired

boolean

descriptionrequired

string

entitiesrequired

object

descriptionrequired

object

urlrequired

object

urlsrequired

array

Array items

object

display_urlrequired

string

expanded_urlrequired

string

indicesrequired

array

Array items

integer

urlrequired

string

fast_followers_countrequired

integer

favourites_countrequired

integer

follow_request_sentrequired

boolean

followed_byrequired

boolean

followers_countrequired

integer

followingrequired

boolean

friends_countrequired

integer

has_custom_timelinesrequired

boolean

is_translatorrequired

boolean

listed_countrequired

integer

locationrequired

string

media_countrequired

integer

mutingrequired

boolean

namerequired

string

needs_phone_verificationrequired

boolean

normal_followers_countrequired

integer

notificationsrequired

boolean

possibly_sensitiverequired

boolean

profile_banner_urlrequired

string

profile_image_url_httpsrequired

string

profile_interstitial_typerequired

string

protectedrequired

boolean

screen_namerequired

string

statuses_countrequired

integer

time_zonerequired

string

translator_typerequired

string

urlrequired

string

utc_offsetrequired

integer

verifiedrequired

boolean

verified_typerequired

string

withheld_descriptionrequired

string

withheld_scoperequired

string

profile_image_shaperequired

string

rest_idrequired

string

super_follow_eligiblerequired

boolean

super_followed_byrequired

boolean

super_followingrequired

boolean

tipjar_settingsrequired

object

bandcamp_handlerequired

string

bitcoin_handlerequired

string

cash_app_handlerequired

string

ethereum_handlerequired

string

gofundme_handlerequired

string

is_enabledrequired

boolean

patreon_handlerequired

string

pay_pal_handlerequired

string

venmo_handlerequired

string

edit_controlrequired

object

edit_tweet_idsrequired

array

Array items

string

editable_until_msecsrequired

string

edits_remainingrequired

string

is_edit_eligiblerequired

boolean

is_translatablerequired

boolean

legacyrequired

object

bookmark_countrequired

integer

bookmarkedrequired

boolean

conversation_id_strrequired

string

created_atrequired

string

display_text_rangerequired

array

Array items

integer

entitiesrequired

object

mediarequired

array

Array items

object

additional_media_inforequired

object

monetizablerequired

boolean

allow_download_statusrequired

object

allow_downloadrequired

boolean

display_urlrequired

string

expanded_urlrequired

string

ext_media_availabilityrequired

object

statusrequired

string

id_strrequired

string

indicesrequired

array

Array items

integer

media_keyrequired

string

media_resultsrequired

object

resultrequired

object

media_keyrequired

string

media_url_httpsrequired

string

original_inforequired

object

focus_rectsrequired

array

heightrequired

integer

widthrequired

integer

sizesrequired

object

largerequired

object

hrequired

integer

resizerequired

string

wrequired

integer

mediumrequired

object

hrequired

integer

resizerequired

string

wrequired

integer

smallrequired

object

hrequired

integer

resizerequired

string

wrequired

integer

thumbrequired

object

hrequired

integer

resizerequired

string

wrequired

integer

typerequired

string

urlrequired

string

video_inforequired

object

aspect_ratiorequired

array

Array items

integer

duration_millisrequired

integer

variantsrequired

array

Array items

object

content_typerequired

string

urlrequired

string

bitrateoptional

integer

extended_entitiesrequired

object

mediarequired

array

Array items

object

additional_media_inforequired

object

monetizablerequired

boolean

allow_download_statusrequired

object

allow_downloadrequired

boolean

display_urlrequired

string

expanded_urlrequired

string

ext_media_availabilityrequired

object

statusrequired

string

id_strrequired

string

indicesrequired

array

Array items

integer

media_keyrequired

string

media_resultsrequired

object

resultrequired

object

media_keyrequired

string

media_url_httpsrequired

string

original_inforequired

object

focus_rectsrequired

array

heightrequired

integer

widthrequired

integer

sizesrequired

object

largerequired

object

hrequired

integer

resizerequired

string

wrequired

integer

mediumrequired

object

hrequired

integer

resizerequired

string

wrequired

integer

smallrequired

object

hrequired

integer

resizerequired

string

wrequired

integer

thumbrequired

object

hrequired

integer

resizerequired

string

wrequired

integer

typerequired

string

urlrequired

string

video_inforequired

object

aspect_ratiorequired

array

Array items

integer

duration_millisrequired

integer

variantsrequired

array

Array items

object

content_typerequired

string

urlrequired

string

bitrateoptional

integer

favorite_countrequired

integer

favoritedrequired

boolean

full_textrequired

string

id_strrequired

string

is_quote_statusrequired

boolean

langrequired

string

possibly_sensitiverequired

boolean

possibly_sensitive_editablerequired

boolean

quote_countrequired

integer

reply_countrequired

integer

retweet_countrequired

integer

retweetedrequired

boolean

user_id_strrequired

string

note_tweetrequired

object

is_expandablerequired

boolean

note_tweet_resultsrequired

object

resultrequired

object

entity_setrequired

object

hashtagsrequired

array

symbolsrequired

array

timestampsrequired

array

urlsrequired

array

user_mentionsrequired

array

idrequired

string

mediarequired

object

inline_mediarequired

array

richtextrequired

object

richtext_tagsrequired

array

textrequired

string

rest_idrequired

string

unmention_datarequired

object

viewsrequired

object

countrequired

string

staterequired

string

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited