> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Community Tweets
> Get the tweets from a Twitter(X) Community
π³ **1 credit** per request
## OpenAPI
````yaml GET /v1/scrape/twitter/community/tweets
openapi: 3.1.0
info:
title: SociaVault API
version: 1.0.0
description: >-
# SociaVault API Documentation
The SociaVault API provides comprehensive access to social media data
extraction across multiple platforms.
## Features
- **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
Reddit, Threads, and more
- **Credit-Based System**: Pay-as-you-go pricing with transparent credit
costs
- **High Performance**: Fast, reliable data extraction
- **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
and analytics
## Authentication
All API requests require authentication using an API key in the `X-API-Key`
header:
```bash
X-API-Key: sk_live_your_api_key_here
```
Get your API key from the [SociaVault
Dashboard](https://sociavault.com/dashboard).
## Credits
Each endpoint consumes credits based on data complexity:
- Simple requests (profiles): 1 credit
- Complex requests (demographics): 20+ credits
- Paginated requests: Credits per page
Check your credit balance in the dashboard or via the API.
## Support
- **Documentation**: https://docs.sociavault.com
- **Email**: support@sociavault.com
- **Discord**: https://discord.gg/sociavault
contact:
name: SociaVault Support
email: support@sociavault.com
url: https://sociavault.com/support
license:
name: Commercial
url: https://sociavault.com/terms
servers:
- url: https://api.sociavault.com
description: Production API
security:
- ApiKeyAuth: []
tags:
- name: account
description: Account management and credit balance
externalDocs:
description: Learn more
url: https://docs.sociavault.com/account
- name: tiktok
description: Scrape TikTok profiles, videos, and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/tiktok
- name: tiktok-shop
description: Everything about TikTok Shop
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/tiktok-shop
- name: instagram
description: Gets Instagram profiles, posts, and reels
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/instagram
- name: youtube
description: Scrape YouTube channels, videos, and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/youtube
- name: linkedin
description: Scrape LinkedIn
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/linkedin
- name: facebook
description: Get public Facebook profiles and posts
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebook
- name: facebookAdLibrary
description: Scrapes the Facebook (Meta) Ad Library
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebookAdLibrary
- name: facebookMarketplace
description: Search Facebook Marketplace and pull full listing details
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebookMarketplace
- name: googleAdLibrary
description: >-
Scrape the Google Ad Transparency Library. *This only gets the public ads.
Some ads you need to log in for and sadly we can't get those. Also, since
there are so many variations, the return types might not all be 100% the
same.
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/googleAdLibrary
- name: linkedinAdLibrary
description: Search the LinkedIn Ad Library
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/linkedinAdLibrary
- name: twitter
description: Get Twitter profiles, tweets, followers and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/twitter
- name: reddit
description: Scrape Reddit posts and comments
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/reddit
- name: threads
description: Get Threads posts
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/threads
- name: google
description: Scrape Google search results
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/google
paths:
/v1/scrape/twitter/community/tweets:
get:
tags:
- twitter
summary: Community Tweets
description: Get the tweets from a Twitter(X) Community
operationId: twitter_Community_Tweets
parameters:
- name: url
in: query
description: Community URL
required: true
schema:
type: string
example: https://x.com/i/communities/1926186499399139650
responses:
'200':
description: |-
Successful response
**Key Response Fields:**
- `tweets[0].id`: Tweet ID string
- `tweets[0].full_text`: Full tweet text content
- `tweets[0].created_at`: Tweet creation timestamp
- `tweets[0].favorite_count`: Like count
- `tweets[0].view_count`: Total view count
- `tweets[0].bookmark_count`: Bookmark count
- `tweets[0].entities.media`: Attached photos/videos
- `tweets[0].entities.user_mentions`: @mentions in the tweet
- `tweets[0].entities.urls`: Expanded URLs in the tweet
content:
application/json:
example:
success: true
data:
success: true
tweets:
'0':
id: '2013630474271498525'
source: >-
Twitter Web App
view_count: '20638'
bookmark_count: 15
bookmarked: false
created_at: Tue Jan 20 15:11:31 +0000 2026
conversation_id_str: '2013630474271498525'
display_text_range:
'0': 0
'1': 87
entities:
hashtags: {}
media:
'0':
display_url: pic.x.com/S7tOAlo8XO
expanded_url: >-
https://x.com/vybhavbhadri/status/2013630474271498525/photo/1
id_str: '2013630453463277568'
indices:
'0': 88
'1': 111
media_key: '3_2013630453463277568'
media_url_https: https://pbs.twimg.com/media/G_HaOo-WYAAIyWN.jpg
type: photo
url: https://t.co/S7tOAlo8XO
ext_media_availability:
status: Available
features:
large:
faces:
'0':
x: 102
'y': 167
h: 130
w: 130
medium:
faces:
'0':
x: 102
'y': 167
h: 130
w: 130
small:
faces:
'0':
x: 58
'y': 95
h: 74
w: 74
orig:
faces:
'0':
x: 102
'y': 167
h: 130
w: 130
sizes:
large:
h: 862
w: 1184
resize: fit
medium:
h: 862
w: 1184
resize: fit
small:
h: 495
w: 680
resize: fit
thumb:
h: 150
w: 150
resize: crop
original_info:
height: 862
width: 1184
focus_rects:
'0':
x: 0
'y': 199
w: 1184
h: 663
'1':
x: 0
'y': 0
w: 862
h: 862
'2':
x: 0
'y': 0
w: 756
h: 862
'3':
x: 0
'y': 0
w: 431
h: 862
'4':
x: 0
'y': 0
w: 1184
h: 862
media_results:
result:
media_key: '3_2013630453463277568'
symbols: {}
timestamps: {}
urls: {}
user_mentions: {}
extended_entities:
media:
'0':
display_url: pic.x.com/S7tOAlo8XO
expanded_url: >-
https://x.com/vybhavbhadri/status/2013630474271498525/photo/1
id_str: '2013630453463277568'
indices:
'0': 88
'1': 111
media_key: '3_2013630453463277568'
media_url_https: https://pbs.twimg.com/media/G_HaOo-WYAAIyWN.jpg
type: photo
url: https://t.co/S7tOAlo8XO
ext_media_availability:
status: Available
features:
large:
faces:
'0':
x: 102
'y': 167
h: 130
w: 130
medium:
faces:
'0':
x: 102
'y': 167
h: 130
w: 130
small:
faces:
'0':
x: 58
'y': 95
h: 74
w: 74
orig:
faces:
'0':
x: 102
'y': 167
h: 130
w: 130
sizes:
large:
h: 862
w: 1184
resize: fit
medium:
h: 862
w: 1184
resize: fit
small:
h: 495
w: 680
resize: fit
thumb:
h: 150
w: 150
resize: crop
original_info:
height: 862
width: 1184
focus_rects:
'0':
x: 0
'y': 199
w: 1184
h: 663
'1':
x: 0
'y': 0
w: 862
h: 862
'2':
x: 0
'y': 0
w: 756
h: 862
'3':
x: 0
'y': 0
w: 431
h: 862
'4':
x: 0
'y': 0
w: 1184
h: 862
media_results:
result:
media_key: '3_2013630453463277568'
favorite_count: 338
favorited: false
full_text: |-
600+ followers, lets go π
If youβre into AI, or tech
say hi!
Follow = follow back https://t.co/S7tOAlo8XO
is_quote_status: false
lang: en
possibly_sensitive: false
possibly_sensitive_editable: true
quote_count: 1
reply_count: 389
retweet_count: 5
retweeted: false
user_id_str: '1945203992142696448'
id_str: '2013630474271498525'
user:
__typename: User
id: VXNlcjoxOTQ1MjAzOTkyMTQyNjk2NDQ4
rest_id: '1945203992142696448'
affiliates_highlighted_label: {}
avatar:
image_url: >-
https://pbs.twimg.com/profile_images/1987845640953778176/IniN-KfM_normal.jpg
core:
created_at: Tue Jul 15 19:29:29 +0000 2025
name: vibe
screen_name: vybhavbhadri
dm_permissions: {}
is_blue_verified: true
legacy:
default_profile: true
default_profile_image: false
description: |-
ai engineer β indie developer π§π»βπ»
building β https://t.co/zLj3dimylV
I build MVPs in weeks π
Credit card optimiser β https://t.co/R8raN5tuAh
entities:
description:
urls:
'0':
display_url: kcetlabs.com
expanded_url: https://kcetlabs.com
url: https://t.co/zLj3dimylV
indices:
'0': 47
'1': 70
'1':
display_url: smartwaytoswipe.online
expanded_url: https://smartwaytoswipe.online
url: https://t.co/R8raN5tuAh
indices:
'0': 120
'1': 143
fast_followers_count: 0
favourites_count: 7484
followers_count: 1603
friends_count: 815
has_custom_timelines: false
is_translator: false
listed_count: 7
media_count: 152
normal_followers_count: 1603
pinned_tweet_ids_str:
'0': '2020394306264338770'
possibly_sensitive: false
profile_banner_url: >-
https://pbs.twimg.com/profile_banners/1945203992142696448/1762882872
profile_interstitial_type: ''
statuses_count: 3771
translator_type: none
withheld_in_countries: {}
location:
location: india
media_permissions: {}
parody_commentary_fan_label: None
profile_image_shape: Circle
professional:
rest_id: '1978440721121292600'
professional_type: Creator
category:
'0':
id: 1059
name: Engineer
icon_name: IconBriefcaseStroke
privacy:
protected: false
relationship_perspectives: {}
tipjar_settings:
is_enabled: false
bandcamp_handle: ''
bitcoin_handle: ''
cash_app_handle: ''
ethereum_handle: ''
gofundme_handle: ''
patreon_handle: ''
pay_pal_handle: ''
venmo_handle: ''
verification:
verified: false
credits_used: 1
endpoint: twitter/community/tweets
'400':
description: Bad Request - Invalid parameters or missing required fields
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: 'Missing required parameter: handle'
endpoint:
type: string
credits_required:
type: integer
required:
- error
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid API key
docs:
type: string
example: https://docs.sociavault.com/authentication
required:
- error
'402':
description: Payment Required - Insufficient credits
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Insufficient credits
required:
type: integer
example: 1
description: Credits required for this request
available:
type: integer
example: 0
description: Credits currently available
required:
- error
- required
- available
'500':
description: Internal Server Error - Service configuration or processing error
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Service configuration error
required:
- error
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: |-
API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
Get your API key from the [Dashboard](https://sociavault.com/dashboard).
````