LogoAIDIR Docs

Community Tweets

API for getting latest tweets from Twitter communities

Community Tweets

Get the latest tweets from a Twitter community.

Request

URL: /api/twitter/community-tweets

Method: GET or POST

Request Parameters:

ParameterTypeRequiredDescription
communityIdstringYesUnique ID of the community

Response

A successful response will return the latest tweets from the community, including tweet content, creation time, author information, etc., sorted in reverse chronological order.

Examples

Request Example

# GET request
curl --request GET \
  --url 'https://www.aidir.fun/api/twitter/community-tweets?communityId=1234567890' \
  --header 'X-API-Key: <api-key>'
 
# POST request
curl --request POST \
  --url 'https://www.aidir.fun/api/twitter/community-tweets' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
    "communityId": "1234567890"
  }'

Response Example

{
  "data": {
    "community": {
      "id": "1234567890",
      "name": "Tech Enthusiasts",
      "description": "A community for tech enthusiasts"
    },
    "tweets": {
      "instructions": [
        {
          "entries": [
            {
              "content": {
                "tweet": {
                  "id": "1512345678901234567",
                  "text": "This is a tweet in the community",
                  "created_at": "2023-04-15T14:34:12.000Z",
                  "author": {
                    "id": "9876543210",
                    "name": "Community Member",
                    "screen_name": "communitymember"
                  },
                  "favorite_count": 123,
                  "retweet_count": 45,
                  "reply_count": 6,
                  "quote_count": 2
                }
              }
            }
          ]
        }
      ]
    }
  }
}

Error Responses

Status CodeDescription
400Request parameter error, e.g., missing required communityId parameter
401Authentication failed, API key invalid or missing
404Community does not exist or no access permission
500Internal server error

Table of Contents