You are viewing an outdated version of our documentation.
For the latest and most accurate information, please visit .
Returns array of tweets from the community timeline. Typically Twitter returns ~20 results per page. You can request additional results by sending another request to the same endpoint using cursor parameter. If the community has a pinned post - this post will be returned on all subsequent requests made with the cursor.
This endpoint doesn't support any filters.
Endpoint
GET https://api.socialdata.tools/twitter/community/[community_id]/tweets
Endpoint parameters
Name
Description
Example
community_id
(Required)
Target community ID
1493446837214187523
type
(required)
Search type (Latest for recent tweets or Top for popular tweets)
Default: Latest
Latest
cursor
(Optional)
Cursor value obtained from next_cursor response property
Maximum number of users to retrieve per single request
Min: 20
Default: 20
Max: 40
20
Common Issues and Best Practices
In languages where the community_id value exceeds the default Integer type limit (e.g., Node.js), store community_id as a string. Use the id_str property returned by the API for these values
Always URL-encode the cursor value when passing it back to the API for subsequent requests
Response codes
HTTP 200 OK - succeeded
HTTP 402 Payment Required - not enough credits to perform this request
HTTP 404 Not Found - requested comminity does not exist
HTTP 422 Unprocessable Content - validation failed (e.g. one of the required parameters was not provided)
HTTP 500Internal Server Error - other error, typically means that SocialData API failed to obtain the requested information and you should try again later
Rate limits
By default each user has a limit of 120 requests per minute shared across all endpoints. Please reach out to support@socialdata.tools if you need to raise your rate limit.
