/v1/twitter/community/tweets

GET

Community Tweets

Get tweets from an X/Twitter Community.

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
`url` Community URL	query / required	`string`

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/community/tweets?url=YOUR_URL' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/twitter/community/tweets?url=YOUR_URL", {
  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/community/tweets?url=YOUR_URL",
    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

idrequired

string

sourcerequired

string

view_countrequired

string

bookmark_countrequired

integer

bookmarkedrequired

boolean

created_atrequired

string

conversation_id_strrequired

string

display_text_rangerequired

array

Array items

integer

favorite_countrequired

integer

favoritedrequired

boolean

full_textrequired

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

id_strrequired

string

userrequired

object

__typenamerequired

string

idrequired

string

rest_idrequired

string

affiliates_highlighted_labelrequired

object

avatarrequired

object

image_urlrequired

string

corerequired

object

created_atrequired

string

namerequired

string

screen_namerequired

string

dm_permissionsrequired

object

is_blue_verifiedrequired

boolean

legacyrequired

object

default_profilerequired

boolean

default_profile_imagerequired

boolean

descriptionrequired

string

entitiesrequired

object

descriptionrequired

object

urlsrequired

array

fast_followers_countrequired

integer

favourites_countrequired

integer

followers_countrequired

integer

friends_countrequired

integer

has_custom_timelinesrequired

boolean

is_translatorrequired

boolean

listed_countrequired

integer

media_countrequired

integer

normal_followers_countrequired

integer

pinned_tweet_ids_strrequired

array

Array items

string

possibly_sensitiverequired

boolean

profile_interstitial_typerequired

string

statuses_countrequired

integer

translator_typerequired

string

withheld_in_countriesrequired

array

locationrequired

object

locationrequired

string

media_permissionsrequired

object

parody_commentary_fan_labelrequired

string

profile_image_shaperequired

string

professionalrequired

object

rest_idrequired

string

professional_typerequired

string

categoryrequired

array

Array items

object

idrequired

integer

namerequired

string

icon_namerequired

string

privacyrequired

object

protectedrequired

boolean

relationship_perspectivesrequired

object

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

verificationrequired

object

verifiedrequired

boolean

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited