搜索推特社区

根据关键词检索相关的推特公开社区。

返回 API 接口列表

/Communities Endpoints

TwexAPI REST

POST/twitter/community/search

API 鉴权

AuthorizationBearer token · header必填

TwexAPI 平台的全局身份凭据 (Bearer Token)。所有接口调用均需在 Header 中携带：Authorization: Bearer <YOUR_TWEXAPI_KEY>。可在 TwexAPI 用户控制台获取。

请求体

必填application/json

querystring必填

要检索的搜索词或语法表达式。

target_countinteger必填

目标获取记录数量上限

响应结果

200community 结构化对象列表

codeinteger必填

HTTP 响应状态码（200 表示成功）

msgstring必填

响应提示信息（例如 'success'）

dataCommunityModel[]必填

接口返回的核心业务数据载荷

展开属性

Array of CommunityModel

idstring必填

要操作的社区唯一 ID

namestring必填

用户昵称/显示名称

descriptionstring必填

个人主页 Bio 自我介绍文本

member_countinteger必填

推特社区内的成员账号总人数

is_nsfwboolean | any

标记该推特社区是否包含成人/敏感内容（NSFW）。

展开属性

Any of:

boolean

boolean

any

any

members_facepile_resultsstring[]

推特社区代表成员的头像图片 URL 列表

bannerobject | any

用户主页横幅背景图片信息

展开属性

Any of:

object

object

any

any

is_memberboolean | any

标记当前账号是否为该推特社区的成员。

展开属性

Any of:

boolean

boolean

any

any

rolestring | any

当前账号在该推特社区中的角色权限（如成员、版主等）

展开属性

Any of:

string

string

any

any

adminUserModel | any

社区管理员账号信息

展开属性

Any of:

UserModel

idstring必填

用户唯一数字 ID

namestring必填

用户昵称/显示名称

screen_namestring必填

推特用户名（Handle，即 @ 后的名称）

created_atstring | any

发布或创建时间（UTC 标准时间格式）

展开属性

Any of:

string

string

any

any

created_at_datetimestring | any

ISO 8601 标准格式的账号注册时间

展开属性

Any of:

string

string

any

any

can_dmboolean | any

当前登录账号是否允许向该用户发送私信

default: false

展开属性

Any of:

boolean

boolean

any

any

can_media_tagboolean | any

他人发推附加图片或视频时是否允许 @ 圈出标记该用户

default: false

展开属性

Any of:

boolean

boolean

any

any

default_profileboolean | any

该用户是否依然使用推特官方默认资料模板

default: false

展开属性

Any of:

boolean

boolean

any

any

default_profile_imageboolean | any

该用户是否依然使用推特默认头像（初始蛋头图）

default: false

展开属性

Any of:

boolean

boolean

any

any

descriptionstring | any

个人主页 Bio 自我介绍文本

default: ""

展开属性

Any of:

string

string

any

any

description_urlsstring[]

在用户 Bio 自我介绍中发现的外部链接 URL 清单

default: []

urlsurlModel[] | any

在用户主页资料中填写的官网链接 URL 清单

展开属性

Any of:

urlModel[]

Array of urlModel

urlstring必填

URL

expanded_urlstring | any

还原后的完整网页跳转 URL

展开属性

Any of:

string

string

any

any

display_urlstring | any

推特卡片上对外展示的缩略 URL

展开属性

Any of:

string

string

any

any

any

any

fast_followers_countinteger | any

优质活跃粉丝数量

default: 0

展开属性

Any of:

integer

integer

any

any

favourites_countinteger | any

该账号历史点赞过的推文总数

default: 0

展开属性

Any of:

integer

integer

any

any

followers_countinteger | any

关注该账号的粉丝总数

default: 0

展开属性

Any of:

integer

integer

any

any

following_countinteger | any

该账号正在关注的账号总数

default: 0

展开属性

Any of:

integer

integer

any

any

has_custom_timelinesboolean | any

该用户主页是否配置了自定义推文聚合时间线

default: false

展开属性

Any of:

boolean

boolean

any

any

is_blue_verifiedboolean | any

是否为推特蓝 V 认证用户（X Premium 会员）

default: false

展开属性

Any of:

boolean

boolean

any

any

verified_typestring | any

推特非个人官方认证徽章类型（blue 蓝 V、business 企业金 V、government 政府灰 V 等）

展开属性

Any of:

string

string

any

any

is_verifiedboolean | any

当账号具备任何形式的官方认证徽章（个人蓝 V、机构金 V、政务灰 V 或经典认证）时为 true

default: false

展开属性

Any of:

boolean

boolean

any

any

profile_image_shapestring | any

用户头像裁切外观（Circle 圆形，Square 方形；方形通常代表官方企业机构或政务账号）

展开属性

Any of:

string

string

any

any

is_translatorboolean | any

该用户是否为推特官方多语言众包译者

default: false

展开属性

Any of:

boolean

boolean

any

any

listed_countinteger | any

该账号被收录进推特公开列表的次数

default: 0

展开属性

Any of:

integer

integer

any

any

locationstring | any

用户在个人主页填写的所在地/国家地区

default: ""

展开属性

Any of:

string

string

any

any

media_countinteger | any

该账号累计发布的图片和视频推文总数

default: 0

展开属性

Any of:

integer

integer

any

any

normal_followers_countinteger | any

普通未认证粉丝数量

default: 0

展开属性

Any of:

integer

integer

any

any

pinned_tweet_idsstring[]

用户个人主页置顶的推文 ID 列表

default: []

possibly_sensitiveboolean | any

该用户的个人主页是否可能涉及限制级/敏感内容

default: false

展开属性

Any of:

boolean

boolean

any

any

profile_banner_urlstring | any

用户个人主页横幅背景图片地址

展开属性

Any of:

string

string

any

any

profile_image_urlstring | any

用户个人主页高清头像图片的访问 URL

展开属性

Any of:

string

string

any

any

protectedboolean | any

该博主的推文是否处于私密锁推保护状态（仅获批粉丝可阅读）

default: false

展开属性

Any of:

boolean

boolean

any

any

statuses_countinteger | any

该账号历史累计发布的推文总数

default: 0

展开属性

Any of:

integer

integer

any

any

any

any

join_policystring | any

社区的加入审批策略规则（如开放加入、需审核等）

展开属性

Any of:

string

string

any

any

created_atinteger | any

发布或创建时间（UTC 标准时间格式）

展开属性

Any of:

integer

integer

any

any

invites_policystring | any

社区的成员邀请权限策略

展开属性

Any of:

string

string

any

any

is_pinnedboolean | any

是否已置顶该列表

展开属性

Any of:

boolean

boolean

any

any

422请求参数校验错误

detailValidationError[]

展开属性

Array of ValidationError

locstring | integer[]必填

展开属性

Array of string | integer

Any of:

string

string

integer

integer

msgstring必填

响应提示信息（例如 'success'）

typestring必填

inputany

ctxobject

⚡交互式测试 / Try APIPOST/twitter/community/search

Live Console

🌐目标服务器:https://api.twexapi.io

● 生产环境就绪

🔍

公开数据读取（仅需 TwexAPI 平台密钥，无需 Twitter Cookie）

本接口为公开推特数据检索/查询，无需任何推特账号或 Cookie！仅需在下方「API 鉴权」中输入您的 TwexAPI 平台密钥 (Bearer Token) 即可直接发起测试。

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

用于调用 TwexAPI 平台全部接口的全局 API 密钥，在控制台获取。

📝请求体application/json

querystring

必填要检索的搜索词或语法表达式。

target_countinteger

必填目标获取记录数量上限

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

请求示例

curl -X POST "https://api.twexapi.io/twitter/community/search" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "string",
  "target_count": 0
}'

const response = await fetch("https://api.twexapi.io/twitter/community/search", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "query": "string",
  "target_count": 0
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/community/search",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "query": "string",
  "target_count": 0
},
)

响应示例

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "member_count": 0,
      "is_nsfw": true,
      "members_facepile_results": [
        "string"
      ],
      "banner": {},
      "is_member": true,
      "role": "string",
      "admin": {
        "id": "1717001045992251392",
        "name": "Cryptoklepto",
        "screen_name": "CK_Cryptoklepto",
        "created_at": "Mon Oct 28 02:32:47 +0000 2024",
        "created_at_datetime": "2024-10-28T02:32:47.000Z",
        "can_dm": false,
        "can_media_tag": false,
        "default_profile": false,
        "default_profile_image": false,
        "description": "",
        "description_urls": [],
        "urls": [
          {
            "url": "https://www.google.com",
            "expanded_url": "https://www.google.com",
            "display_url": "www.google.com"
          }
        ],
        "fast_followers_count": 0,
        "favourites_count": 0,
        "followers_count": 0,
        "following_count": 0,
        "has_custom_timelines": false,
        "is_blue_verified": false,
        "verified_type": "government",
        "is_verified": false,
        "profile_image_shape": "Circle",
        "is_translator": false,
        "listed_count": 0,
        "location": "New York, USA",
        "media_count": 0,
        "normal_followers_count": 0,
        "pinned_tweet_ids": [],
        "possibly_sensitive": false,
        "profile_banner_url": "string",
        "profile_image_url": "string",
        "protected": false,
        "statuses_count": 0
      },
      "join_policy": "string",
      "created_at": 0,
      "invites_policy": "string",
      "is_pinned": true
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}