트위터 커뮤니티 검색

트위터 커뮤니티 검색.

API 참조로 돌아가기

/Communities Endpoints

TwexAPI REST

POST/twitter/community/search

API 인증

AuthorizationBearer token · header필수

TwexAPI 전역 인증 토큰 (Bearer Token). 헤더에 포함되어야 합니다: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

요청 본문

필수application/json

querystring필수

The query to search for.

target_countinteger필수

The number of communities to search.

응답

200A list of community objects.

codeinteger필수

HTTP 상태 코드 (200은 성공)

msgstring필수

응답 메시지 (예: 'success')

dataCommunityModel[]필수

엔드포인트가 반환한 핵심 데이터

속성 표시

Array of CommunityModel

idstring필수

The ID of the community

namestring필수

사용자 이름

descriptionstring필수

프로필 자기소개 (Bio)

member_countinteger필수

The number of members in the community

is_nsfwboolean | any

Indicates if the community is NSFW.

속성 표시

Any of:

boolean

boolean

any

any

members_facepile_resultsstring[]

The profile image URLs of members.

bannerobject | any

The banner information of the community.

속성 표시

Any of:

object

object

any

any

is_memberboolean | any

Indicates if the user is a member of the community.

속성 표시

Any of:

boolean

boolean

any

any

rolestring | any

The role of the user in the community.

속성 표시

Any of:

string

string

any

any

adminUserModel | any

The admin of the community.

속성 표시

Any of:

UserModel

idstring필수

User ID

namestring필수

사용자 이름

screen_namestring필수

트위터 사용자명 (@ 제외)

created_atstring | any

작성 일시 (UTC 기준)

속성 표시

Any of:

string

string

any

any

created_at_datetimestring | any

Account creation datetime in ISO format

속성 표시

Any of:

string

string

any

any

can_dmboolean | any

Whether the user can be direct messaged

default: false

속성 표시

Any of:

boolean

boolean

any

any

can_media_tagboolean | any

Whether the user can be tagged in media

default: false

속성 표시

Any of:

boolean

boolean

any

any

default_profileboolean | any

Whether the user has a default profile

default: false

속성 표시

Any of:

boolean

boolean

any

any

default_profile_imageboolean | any

Whether the user has a default profile image

default: false

속성 표시

Any of:

boolean

boolean

any

any

descriptionstring | any

프로필 자기소개 (Bio)

default: ""

속성 표시

Any of:

string

string

any

any

description_urlsstring[]

List of URLs found in the user's description

default: []

urlsurlModel[] | any

List of URLs found in the user's profile

속성 표시

Any of:

urlModel[]

Array of urlModel

urlstring필수

URL

expanded_urlstring | any

Expanded URL

속성 표시

Any of:

string

string

any

any

display_urlstring | any

Display URL

속성 표시

Any of:

string

string

any

any

any

any

fast_followers_countinteger | any

Count of fast followers

default: 0

속성 표시

Any of:

integer

integer

any

any

favourites_countinteger | any

Number of tweets the user has liked

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

Whether the user has custom timelines

default: false

속성 표시

Any of:

boolean

boolean

any

any

is_blue_verifiedboolean | any

Blue verification status

default: false

속성 표시

Any of:

boolean

boolean

any

any

verified_typestring | any

Verification badge type when not blue-only: blue, business, government, etc.

속성 표시

Any of:

string

string

any

any

is_verifiedboolean | any

True if the account has any verification badge (blue, business, government, or legacy verified)

default: false

속성 표시

Any of:

boolean

boolean

any

any

profile_image_shapestring | any

Profile image shape (Circle or Square; Square often indicates business/government)

속성 표시

Any of:

string

string

any

any

is_translatorboolean | any

Whether the user is a translator

default: false

속성 표시

Any of:

boolean

boolean

any

any

listed_countinteger | any

Number of public lists the user is a member of

default: 0

속성 표시

Any of:

integer

integer

any

any

locationstring | any

User's location

default: ""

속성 표시

Any of:

string

string

any

any

media_countinteger | any

Number of media tweets posted by the user

default: 0

속성 표시

Any of:

integer

integer

any

any

normal_followers_countinteger | any

Count of normal followers

default: 0

속성 표시

Any of:

integer

integer

any

any

pinned_tweet_idsstring[]

List of pinned tweet IDs

default: []

possibly_sensitiveboolean | any

Whether the user's profile may contain sensitive content

default: false

속성 표시

Any of:

boolean

boolean

any

any

profile_banner_urlstring | any

URL of the user's profile banner

속성 표시

Any of:

string

string

any

any

profile_image_urlstring | any

URL of the user's profile image

속성 표시

Any of:

string

string

any

any

protectedboolean | any

Whether the user's tweets are protected

default: false

속성 표시

Any of:

boolean

boolean

any

any

statuses_countinteger | any

Number of tweets posted by the user

default: 0

속성 표시

Any of:

integer

integer

any

any

any

any

join_policystring | any

The join policy of the community.

속성 표시

Any of:

string

string

any

any

created_atinteger | any

작성 일시 (UTC 기준)

속성 표시

Any of:

integer

integer

any

any

invites_policystring | any

The invites policy of the community.

속성 표시

Any of:

string

string

any

any

is_pinnedboolean | any

Indicates if the community is pinned.

속성 표시

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

⚡대화형 콘솔 / API 테스트POST/twitter/community/search

Live Console

🌐대상 서버:https://api.twexapi.io

● 프로덕션 준비 완료

🔍

공개 데이터 조회 (TwexAPI 키만 필요, Twitter 쿠키 불필요)

이 엔드포인트는 공개 Twitter 데이터를 조회합니다. Twitter 계정이나 쿠키가 필요하지 않습니다! 아래 "API 인증"에 TwexAPI 플랫폼 키 (Bearer Token)를 입력하여 바로 테스트하세요.

🔑API 인증

키 기억하기코드 예제에 동기화

TwexAPI 플랫폼 키 Bearer Token필수

모든 TwexAPI 엔드포인트에서 사용되는 글로벌 API 키입니다. 대시보드에서 확인하세요.

📝요청 본문application/json

querystring

필수The query to search for.

target_countinteger

필수The number of communities to search.

💡 빠른 전송:⌘ / 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": {}
    }
  ]
}