# 依 ID 取得社群資訊

**API:** Data API

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

**Tags:** Twitter / X

依數字社群 ID 取得 X 社群的其中繼資料——名稱、描述、成員數與存取規則。用它先評估社群，再擷取其成員或貼文。物件位於 `community_info` 之下。若要依主題探索社群，請以 `get_twitter_community_tweets_all` 搜尋其貼文。

### 計費參考

- 計量方式：以成功請求為固定成本基礎。
- 參考請求估算：0.0002 美元。
- 參考客戶乘數：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 |

## Responses

### 200 — 社群資訊回應

Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。

**application/json**

Schema: `Response8D25370A403A_CommunityInfoResponse` (`#/components/schemas/Response8D25370A403A_CommunityInfoResponse`)

### 400 — 無法處理該要求。請檢查請求參數。

### 401 — 需要有效的 Felo API 金鑰。

### 402 — 由於未符合計費要求，要求無法繼續。

### 403 — 該帳戶無權執行此操作。

### 429 — 已達到要求或支出上限。

### 502 — 服務無法完成該要求。

### 503 — API 或計費服務暫時無法使用。

### 504 — 服務在處理要求時逾時。

### default — 錯誤回應；上游透傳回應可能採用供應商格式

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response8D25370A403A_CommunityInfo

`#/components/schemas/Response8D25370A403A_CommunityInfo`

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "question": {
      "type": [
        "string",
        "null"
      ]
    },
    "member_count": {
      "type": "integer"
    },
    "moderator_count": {
      "type": "integer"
    },
    "created_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "join_policy": {
      "type": [
        "string",
        "null"
      ]
    },
    "invites_policy": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_nsfw": {
      "type": "boolean"
    },
    "is_pinned": {
      "type": "boolean"
    },
    "role": {
      "type": [
        "string",
        "null"
      ]
    },
    "primary_topic": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "banner_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "search_tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    "creator": {
      "$ref": "#/components/schemas/Response8D25370A403A_User"
    },
    "admin": {
      "$ref": "#/components/schemas/Response8D25370A403A_User"
    },
    "members_preview": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}
```

### Response8D25370A403A_CommunityInfoResponse

`#/components/schemas/Response8D25370A403A_CommunityInfoResponse`

```json
{
  "type": "object",
  "properties": {
    "community_info": {
      "$ref": "#/components/schemas/Response8D25370A403A_CommunityInfo"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "msg": {
      "type": "string"
    }
  }
}
```

### 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"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```