# Получить твиты сообщества

**API:** Data API

**Endpoint:** `GET /v1/beta/twitter/community/tweets`

**Tags:** Twitter / X

Возвращает публикации внутри одного конкретного сообщества X с постраничной навигацией по курсору. Используйте, чтобы прочитать, что на самом деле обсуждает известное сообщество. Возвращает полные объекты твитов со счётчиками вовлечённости. Если не знаете, какое сообщество смотреть, ищите по всем сразу через `get_twitter_community_tweets_all`.

### Справочная информация о ценах

- Тарификация: тарифицируемое количество результатов.
- Справочная оценка запроса: USD 0.003.
- Минимальная базовая стоимость: USD 0.00015.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
- Базовые стоимости не определяют итоговую цену для клиента, в том числе когда они равны нулю.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `community_id` | query | yes | string | ID сообщества |
| `cursor` | query | no | string | Курсор пагинации |

## Responses

### 200 — Ответ с твитами сообщества

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "tweets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Response8D25370A403A_Tweet"
      }
    },
    "has_next_page": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": "string"
    },
    "has_next": {
      "type": "boolean"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "msg": {
      "type": "string"
    }
  }
}
```

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response8D25370A403A_Tweet

`#/components/schemas/Response8D25370A403A_Tweet`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "retweetCount": {
      "type": "integer"
    },
    "replyCount": {
      "type": "integer"
    },
    "likeCount": {
      "type": "integer"
    },
    "quoteCount": {
      "type": "integer"
    },
    "viewCount": {
      "type": "integer"
    },
    "createdAt": {
      "type": "string"
    },
    "lang": {
      "type": "string"
    },
    "bookmarkCount": {
      "type": "integer"
    },
    "isReply": {
      "type": "boolean"
    },
    "inReplyToId": {
      "type": "string"
    },
    "conversationId": {
      "type": "string"
    },
    "displayTextRange": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "inReplyToUserId": {
      "type": "string"
    },
    "inReplyToUsername": {
      "type": "string"
    },
    "author": {
      "$ref": "#/components/schemas/Response8D25370A403A_User"
    },
    "entities": {
      "type": "object",
      "properties": {
        "hashtags": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "indices": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "text": {
                "type": "string"
              }
            }
          }
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "display_url": {
                "type": "string"
              },
              "expanded_url": {
                "type": "string"
              },
              "indices": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "url": {
                "type": "string"
              }
            }
          }
        },
        "user_mentions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id_str": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "screen_name": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "quoted_tweet": {
      "type": "string"
    },
    "retweeted_tweet": {
      "type": "string"
    },
    "isLimitedReply": {
      "type": "boolean"
    }
  }
}
```

### Response8D25370A403A_User

`#/components/schemas/Response8D25370A403A_User`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "userName": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "isBlueVerified": {
      "type": "boolean"
    },
    "verifiedType": {
      "type": "string"
    },
    "profilePicture": {
      "type": "string"
    },
    "coverPicture": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "followers": {
      "type": "integer"
    },
    "following": {
      "type": "integer"
    },
    "canDm": {
      "type": "boolean"
    },
    "createdAt": {
      "type": "string"
    },
    "favouritesCount": {
      "type": "integer"
    },
    "hasCustomTimelines": {
      "type": "boolean"
    },
    "isTranslator": {
      "type": "boolean"
    },
    "mediaCount": {
      "type": "integer"
    },
    "statusesCount": {
      "type": "integer"
    },
    "withheldInCountries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "possiblySensitive": {
      "type": "boolean"
    },
    "pinnedTweetIds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "isAutomated": {
      "type": "boolean"
    },
    "automatedBy": {
      "type": "string"
    },
    "unavailable": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "unavailableReason": {
      "type": "string"
    },
    "profile_bio": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string"
        },
        "entities": {
          "type": "object",
          "properties": {
            "description": {
              "type": "object",
              "properties": {
                "urls": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "display_url": {
                        "type": "string"
                      },
                      "expanded_url": {
                        "type": "string"
                      },
                      "indices": {
                        "type": "array",
                        "items": {
                          "type": "integer"
                        }
                      },
                      "url": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            },
            "url": {
              "type": "object",
              "properties": {
                "urls": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "display_url": {
                        "type": "string"
                      },
                      "expanded_url": {
                        "type": "string"
                      },
                      "indices": {
                        "type": "array",
                        "items": {
                          "type": "integer"
                        }
                      },
                      "url": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```