사용자 검색

키워드로 사용자를 검색합니다

User Search 엔드포인트를 사용하면 키워드로 사용자를 검색할 수 있습니다. 이름, 사용자 이름(username), 또는 프로필 소개(bio)에 포함된 내용으로 사용자를 찾을 수 있습니다.

​

개요

키워드 검색

이름, 사용자 이름 또는 프로필 소개로 검색

사용자 찾기

관련성이 높은 계정 찾기

---

​

엔드포인트

Method	Endpoint	Description
GET	/2/users/search	사용자를 검색

---

​

예제 요청

curl "https://api.x.com/2/users/search?\
query=python%20developer&\
user.fields=description,verified,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

응답 예시

{
  "data": [
    {
      "id": "1234567890",
      "name": "Python Developer",
      "username": "pythondev",
      "description": "Building cool things with Python",
      "verified": false,
      "public_metrics": {
        "followers_count": 5000,
        "following_count": 200,
        "tweet_count": 1500
      }
    }
  ],
  "meta": {
    "result_count": 1
  }
}

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 Project와 App
• App의 키와 토큰

사용자 조회

ID 또는 사용자 이름으로 사용자 찾기

API 참조 문서

전체 엔드포인트에 대한 문서