플랫폼 가용성
- 24시간 상태
- 87%
최근 30일
제공 기능
각 X (Twitter) 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 트윗을 검색해 JSON으로 받습니다. | 요청 1,000개당 $0.56 | 양호 · 상태 100% |
프로필profile | X(Twitter) 핸들의 소개, 위치, 팔로워·팔로잉·게시물 수, 인증 여부, 계정 생성일을 확인합니다. | 요청 1,000개당 $0.56 | 정상 |
사용자 게시물user_posts | X(Twitter) 계정의 게시물을 가져오며, 각 게시물의 좋아요·리포스트·답글·조회수와 게시 시각이 포함됩니다. | 요청 1,000개당 $0.56 | 정상 |
게시물 상세 정보post | 숫자 ID로 X(Twitter) 게시물 하나를 가져오며, 전체 텍스트, 작성자, 게시 시각, 좋아요·리포스트·답글·조회수가 포함됩니다. | 요청 1,000개당 $0.56 | 정상 |
댓글comments | X(Twitter) 게시물의 답글을 수집합니다. | 요청 1,000개당 $0.56 | 정상 |
인기 급상승trending | X(Twitter)의 트렌드 주제를 순위, 논의량, 기간, 수집 시각과 함께 나열합니다. | 요청 1,000개당 $0.56 | 정상 |
팔로워 목록followers_list | 팔로워를 통해 X(Twitter) 계정의 오디언스를 파악합니다. | 요청 1,000개당 $0.56 | 정상 |
팔로잉 목록following_list | X(Twitter) 사용자가 팔로우하는 계정을 가져오며, 각 계정의 소개, 위치, 팔로워 수와 게시물 수, 인증 여부가 포함됩니다. | 요청 1,000개당 $0.56 | 정상 |
미디어 게시물user_media | username으로 X(Twitter) 계정의 미디어 탭 게시물, 즉 사진이나 동영상이 포함된 게시물을 최신순으로 나열합니다. | 요청 1,000개당 $0.81 | 정상 |
답글 탭user_replies | username으로 X(Twitter) 계정의 답글 탭 게시물을 최신순으로 나열합니다. | 요청 1,000개당 $0.81 | 정상 |
재게시한 사용자retweeters | 숫자 id로 X(Twitter) 게시물 하나를 리포스트한 계정을 나열합니다. | 요청 1,000개당 $0.81 | 정상 |
사용자 ID별 프로필profiles_by_ids | user_ids에 숫자 사용자 ID를 넣어 X(Twitter) 계정을 한 번에 최대 20개까지 조회합니다. | 요청 1,000개당 $0.81 | 정상 |
계정 정보user_about | username으로 X(Twitter) 사용자의 '이 계정 정보' 페이지를 읽습니다. | 요청 1,000개당 $0.81 | 정상 |
팔로우 여부 확인check_follow | X(Twitter) 계정 하나가 다른 계정을 팔로우하는지 확인합니다. | 요청 1,000개당 $0.81 | 정상 |
재게시 여부 확인check_retweet | X(Twitter) 계정이 특정 게시물을 리포스트했는지 확인합니다. | 요청 1,000개당 $0.81 | 정상 |
커뮤니티 상세 정보community_info | 숫자 community_id로 X(Twitter) 커뮤니티 하나를 읽어 옵니다. | 요청 1,000개당 $0.81 | 정상 |
커뮤니티 검색search_communities | keyword로 X(Twitter) 커뮤니티를 검색합니다. | 요청 1,000개당 $0.81 | 정상 |
사용자 검색search_users | 사용자 탭과 같은 방식으로 keyword로 X(Twitter) 계정을 검색하며, 사용자 이름, 표시 이름, 소개에서 일치 항목을 찾습니다. | 요청 1,000개당 $0.56 | 정상 |
동영상 스크립트video_transcript | 게시물 링크나 ID로 X(Twitter) 동영상 게시물의 음성을 텍스트로 변환합니다. | 요청 1,000개당 $0.96 | 정상 |
스레드thread | X(Twitter) 게시물 링크 하나를 전달하면 작성자가 올린 스레드 전체를 첫 게시물부터 최대 100개까지 가져옵니다. | 요청 1,000개당 $2.15 | 정상 |
커뮤니티 게시물community_posts | 숫자 community_id로 X(Twitter) 커뮤니티 하나의 최신 게시물을 읽습니다. | 요청 1,000개당 $0.81 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
X (Twitter) 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 트윗을 검색해 JSON으로 받습니다. 각 게시물에는 텍스트, 작성자, 팔로워 수, 참여 수치가 포함됩니다. 쿼리에는 from:, since: 같은 연산자를 사용할 수 있습니다. 기본적으로 인기 결과가 먼저 나옵니다. 최신 게시물은 엄격한 시간순이 아닐 수 있습니다. | keyword | sort | Sync 응답 | 카탈로그 값: defaultLimit=25, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform |
profile프로필 X(Twitter) 핸들의 소개, 위치, 팔로워·팔로잉·게시물 수, 인증 여부, 계정 생성일을 확인합니다. 사용자 이름은 @를 붙이거나 빼고 전달할 수 있으며, 프로필 URL은 사용할 수 없습니다. 결과는 신원, 현재 활동 여부, 오디언스 구성을 확인해 주지 않습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $0.56 | user_id · username · display_name · bio · url · follower_count · following_count · post_count · is_verified · location · avatar_url · created_at · platform |
user_posts사용자 게시물 X(Twitter) 계정의 게시물을 가져오며, 각 게시물의 좋아요·리포스트·답글·조회수와 게시 시각이 포함됩니다. 한 번의 호출 결과에 모든 게시물, 답글, 리포스트가 담기지 않을 수 있으며, 다이렉트 메시지는 절대 포함되지 않습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform |
post게시물 상세 정보 숫자 ID로 X(Twitter) 게시물 하나를 가져오며, 전체 텍스트, 작성자, 게시 시각, 좋아요·리포스트·답글·조회수가 포함됩니다. JavaScript에서 숫자가 반올림되지 않도록 ID는 문자열로 유지해야 하며, 전체 링크를 전달하면 안 됩니다. | id | tweet_id | Sync 응답 | — | 요청 1,000개당 $0.56 | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform |
comments댓글 X(Twitter) 게시물의 답글을 수집합니다. 각 답글에는 본문, 작성자, 작성자의 팔로워 수, 답글 자체의 반응 수치가 포함됩니다. 원 게시물의 숫자 | id | tweet_id | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform |
trending인기 급상승 X(Twitter)의 트렌드 주제를 순위, 논의량, 기간, 수집 시각과 함께 나열합니다. | country | Sync 응답 | — | 요청 1,000개당 $0.56 | id · name · rank · volume · period · collected_at · platform | |
followers_list팔로워 목록 팔로워를 통해 X(Twitter) 계정의 오디언스를 파악합니다. 각 팔로워에는 소개, 위치, 각종 수치, 인증 여부, 비공개 계정 여부가 포함됩니다. 목록에는 X가 공개하는 팔로워만 포함되며 일부만 반환될 수 있습니다. 각 행의 수치는 해당 팔로워의 것입니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=200, maxLimit=2000. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform |
following_list팔로잉 목록 X(Twitter) 사용자가 팔로우하는 계정을 가져오며, 각 계정의 소개, 위치, 팔로워 수와 게시물 수, 인증 여부가 포함됩니다. 팔로우 목록은 언제든 바뀔 수 있으며, 친밀도나 상호작용을 입증하지 않습니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=200, maxLimit=2000. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform |
user_media미디어 게시물
| username | page_token | Sync 응답 | 호출 한 번에 최대 12행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_quote · is_repost · is_pinned · source · media · author_id · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform |
user_replies답글 탭
| username | page_token | Sync 응답 | 호출 한 번에 최대 30행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform |
retweeters재게시한 사용자 숫자 | id | page_token, url | Sync 응답 | 호출 한 번에 최대 100행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | media_count · next_page_token · id · username · url · name · text · follower_count · following_count · post_count · platform |
profiles_by_ids사용자 ID별 프로필
| user_ids | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=20. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.81 | user_id · username · display_name · url · location · is_verified · is_protected · affiliation · avatar_url · created_at · account_status · platform |
user_about계정 정보
| username | — | Sync 응답 | — | 요청 1,000개당 $0.81 | user_id · username · display_name · url · account_based_in · is_location_accurate · signup_source · username_change_count · last_username_change_at · is_verified · verified_since · is_protected · affiliation · avatar_url · account_status · platform |
check_follow팔로우 여부 확인 X(Twitter) 계정 하나가 다른 계정을 팔로우하는지 확인합니다. 팔로워일 수 있는 계정을 | username, target_username | — | Sync 응답 | — | 요청 1,000개당 $0.81 | username · target_username · is_following · platform |
check_retweet재게시 여부 확인 X(Twitter) 계정이 특정 게시물을 리포스트했는지 확인합니다. | username, id | url | Sync 응답 | — | 요청 1,000개당 $0.81 | username · post_id · is_retweeted · platform |
community_info커뮤니티 상세 정보 숫자 | community_id | url | Sync 응답 | — | 요청 1,000개당 $0.81 | id · url · name · description · topic · member_count · is_nsfw · banner_url · created_at · rules · platform |
search_communities커뮤니티 검색
| keyword | page_token | Sync 응답 | 호출 한 번에 최대 10행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | id · url · name · topic · member_count · is_nsfw · banner_url · platform · next_page_token |
search_users사용자 검색 사용자 탭과 같은 방식으로 | keyword | page_token | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.56 | next_page_token · id · username · url · name · text · avatar_url · follower_count · following_count · post_count · is_verified · created_at · platform |
video_transcript동영상 스크립트 게시물 링크나 ID로 X(Twitter) 동영상 게시물의 음성을 텍스트로 변환합니다. 게시물 ID, 링크, | url | id | Sync 응답 | — | 요청 1,000개당 $0.96 | id · url · text · word_count |
thread스레드 X(Twitter) 게시물 링크 하나를 전달하면 작성자가 올린 스레드 전체를 첫 게시물부터 최대 100개까지 가져옵니다. 각 게시물에는 텍스트, 미디어, 참여 수치, 게시 시각, 작성자 정보가 포함됩니다. 다른 계정의 답글은 포함되지 않습니다. | url | id | Sync 응답 | 카탈로그 값: defaultLimit=100, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $2.15 | id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · reply_to_id · source · media · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_created_at · author_banner_url · platform |
community_posts커뮤니티 게시물 숫자 | community_id | page_token, url | Sync 응답 | 호출 한 번에 최대 20행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다. | 요청 1,000개당 $0.81 | next_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · quote_count · language · is_quote · is_repost · is_pinned · source · media · author_id · author_is_verified · platform |
X (Twitter) search 파라미터는 각각 무엇을 의미하나요?
키워드로 트윗을 검색해 JSON으로 받습니다. 각 게시물에는 텍스트, 작성자, 팔로워 수, 참여 수치가 포함됩니다. 쿼리에는 from:, since: 같은 연산자를 사용할 수 있습니다. 기본적으로 인기 결과가 먼저 나옵니다. 최신 게시물은 엄격한 시간순이 아닐 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- X 게시물 검색어이며, from:이나 since: 같은 플랫폼 검색 연산자를 포함할 수 있습니다. 정렬은 sort를 참고하세요.
sort선택- 정렬 방식입니다. latest는 최신 게시물을 먼저 요청합니다. X는 기본적으로 Top 결과를 반환하며, latest를 지정해도 엄격한 시간순 결과를 보장하지 않습니다.
X (Twitter) profile 파라미터는 각각 무엇을 의미하나요?
X(Twitter) 핸들의 소개, 위치, 팔로워·팔로잉·게시물 수, 인증 여부, 계정 생성일을 확인합니다. 사용자 이름은 @를 붙이거나 빼고 전달할 수 있으며, 프로필 URL은 사용할 수 없습니다. 결과는 신원, 현재 활동 여부, 오디언스 구성을 확인해 주지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- X 사용자 이름이며, @ 접두사는 선택이고 프로필 전체 URL은 입력하지 않습니다. profile은 최근 게시물의 작성자 정보에서 데이터를 모으고, followers_list와 following_list는 각각 표시되는 팔로워와 팔로잉 계정을 가져옵니다.X: username / handle과 표시 이름의 차이 — X는 핸들과 표시 이름을 구분합니다. 핸들은 @ 식별자와 프로필 링크를 구성하며, 핸들을 변경하면 기존 핸들을 다른 사용자가 가져갈 수 있습니다. 아카이빙할 때는 표시 이름이나 변경 가능한 핸들에만 의존해 신원을 확인하지 마십시오. · 확인일
X (Twitter) user_posts 파라미터는 각각 무엇을 의미하나요?
X(Twitter) 계정의 게시물을 가져오며, 각 게시물의 좋아요·리포스트·답글·조회수와 게시 시각이 포함됩니다. 한 번의 호출 결과에 모든 게시물, 답글, 리포스트가 담기지 않을 수 있으며, 다이렉트 메시지는 절대 포함되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- X 사용자 이름이며, @ 접두사는 선택이고 프로필 전체 URL은 입력하지 않습니다. profile은 최근 게시물의 작성자 정보에서 데이터를 모으고, followers_list와 following_list는 각각 표시되는 팔로워와 팔로잉 계정을 가져옵니다.X: username / handle과 표시 이름의 차이 — X는 핸들과 표시 이름을 구분합니다. 핸들은 @ 식별자와 프로필 링크를 구성하며, 핸들을 변경하면 기존 핸들을 다른 사용자가 가져갈 수 있습니다. 아카이빙할 때는 표시 이름이나 변경 가능한 핸들에만 의존해 신원을 확인하지 마십시오. · 확인일
X (Twitter) post 파라미터는 각각 무엇을 의미하나요?
숫자 ID로 X(Twitter) 게시물 하나를 가져오며, 전체 텍스트, 작성자, 게시 시각, 좋아요·리포스트·답글·조회수가 포함됩니다. JavaScript에서 숫자가 반올림되지 않도록 ID는 문자열로 유지해야 하며, 전체 링크를 전달하면 안 됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태id필수- post 또는 comments에 사용할 숫자 게시물 ID로, x.com/username/status/ 뒤의 숫자에 해당합니다. JavaScript의 큰 정수 정밀도 손실을 막으려면 문자열로 저장하는 것을 권장하며, id에 전체 URL을 전달하지 마세요.X: 조회수는 순 사용자 수와 같지 않다 — X는 같은 사람이 여러 번 조회하면 조회수가 여러 번 집계될 수 있고, 일부 게시물은 조회수를 제공하지 않는다고 설명합니다. 이는 지표 정의에 대한 설명이며, 이 엔드포인트가 보호된 콘텐츠나 비공개 분석 데이터에 접근할 수 있다는 의미는 아닙니다. · 확인일
tweet_id선택- id의 호환용 입력으로, id보다 우선순위가 낮으며 필수 공개 필드인 id를 대체하지 않습니다.
X (Twitter) comments 파라미터는 각각 무엇을 의미하나요?
X(Twitter) 게시물의 답글을 수집합니다. 각 답글에는 본문, 작성자, 작성자의 팔로워 수, 답글 자체의 반응 수치가 포함됩니다. 원 게시물의 숫자 id를 전달해야 합니다. 전체 대화는 보장되지 않습니다.
id필수- post 또는 comments에 사용할 숫자 게시물 ID로, x.com/username/status/ 뒤의 숫자에 해당합니다. JavaScript의 큰 정수 정밀도 손실을 막으려면 문자열로 저장하는 것을 권장하며, id에 전체 URL을 전달하지 마세요.X: 원본 게시물 ID, 대화 ID, 답글 관계 — X는 conversation_id로 대화를 시작한 원본 게시물 ID를 나타내며, 여러 단계의 답글이 이 값을 공유할 수 있습니다. 부모-자식 관계를 재구성하려면 상위 게시물 식별자가 필요합니다. 이 엔드포인트는 이러한 관계 필드를 제공하지 않으므로, 현재 출력에서 공식 예시와 같은 답글 트리를 기대해서는 안 됩니다. · 확인일
tweet_id선택- id의 호환용 입력으로, id보다 우선순위가 낮으며 필수 공개 필드인 id를 대체하지 않습니다.
X (Twitter) trending 파라미터는 각각 무엇을 의미하나요?
X(Twitter)의 트렌드 주제를 순위, 논의량, 기간, 수집 시각과 함께 나열합니다. country로 지역을 선택하며 기본값은 전 세계입니다. rank와 volume은 한 시점의 관측값이며, 알고리즘이나 이력을 나타내지 않습니다.
country선택- 인기 급상승 목록의 지역 코드이며, 기본값은 전 세계 기준인 world입니다. us, ca, mx, uk/gb, fr, de, it, es, pt, nl, dk, at, be, ch, gr, ru, tr, kr, sg, id, ph, vn, th, au, il, ae, sa, ar, br, eg, ng, ke, za, jp 및 일부 영어 국가명을 지원합니다. 인식되지 않는 입력값은 전 세계 순위를 반환합니다.X: 지역별 트렌드와 개인화 추천은 어떻게 다른가 — X는 지역별 트렌드와 위치·관심사 신호에 기반한 개인화 추천을 구분합니다. 이는 country 파라미터의 용도를 이해하는 데 도움이 되지만, 반환 순서가 특정 사용자의 추천 페이지와 일치한다고 보장하지 않으며 공식 트렌드 모델 점수를 제공하지도 않습니다. · 확인일
X (Twitter) followers_list 파라미터는 각각 무엇을 의미하나요?
팔로워를 통해 X(Twitter) 계정의 오디언스를 파악합니다. 각 팔로워에는 소개, 위치, 각종 수치, 인증 여부, 비공개 계정 여부가 포함됩니다. 목록에는 X가 공개하는 팔로워만 포함되며 일부만 반환될 수 있습니다. 각 행의 수치는 해당 팔로워의 것입니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- X 사용자 이름이며, @ 접두사는 선택이고 프로필 전체 URL은 입력하지 않습니다. profile은 최근 게시물의 작성자 정보에서 데이터를 모으고, followers_list와 following_list는 각각 표시되는 팔로워와 팔로잉 계정을 가져옵니다.X: 팔로워와 팔로잉은 방향이 다르다 — X는 팔로우가 상호적일 필요가 없으므로 나를 팔로우하는 사람과 내가 팔로우하는 사람을 따로 설명하며, 보호된 게시물에는 추가 접근 제한이 적용됩니다. 목록 조회는 일괄 팔로우 액션이 아니며, 접근 권한이 확대된다는 의미도 아닙니다. · 확인일
X (Twitter) following_list 파라미터는 각각 무엇을 의미하나요?
X(Twitter) 사용자가 팔로우하는 계정을 가져오며, 각 계정의 소개, 위치, 팔로워 수와 게시물 수, 인증 여부가 포함됩니다. 팔로우 목록은 언제든 바뀔 수 있으며, 친밀도나 상호작용을 입증하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- X 사용자 이름이며, @ 접두사는 선택이고 프로필 전체 URL은 입력하지 않습니다. profile은 최근 게시물의 작성자 정보에서 데이터를 모으고, followers_list와 following_list는 각각 표시되는 팔로워와 팔로잉 계정을 가져옵니다.X: 팔로워와 팔로잉은 방향이 다르다 — X는 팔로우가 상호적일 필요가 없으므로 나를 팔로우하는 사람과 내가 팔로우하는 사람을 따로 설명하며, 보호된 게시물에는 추가 접근 제한이 적용됩니다. 목록 조회는 일괄 팔로우 액션이 아니며, 접근 권한이 확대된다는 의미도 아닙니다. · 확인일
X (Twitter) user_media 파라미터는 각각 무엇을 의미하나요?
username으로 X(Twitter) 계정의 미디어 탭 게시물, 즉 사진이나 동영상이 포함된 게시물을 최신순으로 나열합니다. 각 게시물에는 텍스트, media, 좋아요·리포스트·답글·조회수, 게시 시각, 작성자 정보가 포함됩니다. 페이지당 약 12개이며 개수는 달라질 수 있습니다. next_page_token으로 다음 페이지를 가져옵니다.
username필수- 사진 및 동영상 게시물을 가져올 계정입니다(예:
NASA). 앞의 @는 제거됩니다. page_token선택user_media,user_replies,retweeters,search_communities,community_posts,search_users의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
X (Twitter) user_replies 파라미터는 각각 무엇을 의미하나요?
username으로 X(Twitter) 계정의 답글 탭 게시물을 최신순으로 나열합니다. 각 게시물에는 텍스트, is_reply와 reply_to_id, 참여 수치, 해시태그, 멘션, 링크가 포함됩니다. 해당 계정이 직접 작성한 게시물만 반환되며, 답글 대상 게시물은 포함되지 않습니다. 페이지당 약 30개이며 개수는 달라질 수 있습니다. next_page_token으로 다음 페이지를 가져옵니다.
username필수- 답글을 가져올 계정입니다(예:
NASA). 앞의 @는 제거됩니다. page_token선택user_media,user_replies,retweeters,search_communities,community_posts,search_users의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
X (Twitter) retweeters 파라미터는 각각 무엇을 의미하나요?
숫자 id로 X(Twitter) 게시물 하나를 리포스트한 계정을 나열합니다. 각 계정에는 사용자 이름, 이름, 소개, 팔로워·팔로잉·게시물 수가 포함됩니다. 페이지당 최대 100개이며, next_page_token으로 다음 페이지를 가져옵니다. X에 아직 표시되는 리포스트만 나열됩니다.
id필수- 게시물의 숫자 ID로, 링크에서 /status/ 뒤에 오는 숫자입니다. 문자열로 유지해야 합니다.
page_token선택user_media,user_replies,retweeters,search_communities,community_posts,search_users의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.url선택- 호환용 입력으로, 게시물 링크 https://x.com/<username>/status/<ID>를 입력합니다.
id가 우선합니다.
X (Twitter) profiles_by_ids 파라미터는 각각 무엇을 의미하나요?
user_ids에 숫자 사용자 ID를 넣어 X(Twitter) 계정을 한 번에 최대 20개까지 조회합니다. 각 계정에는 사용자 이름, 표시 이름, 프로필 링크, 위치, 인증 여부, 비공개 여부, 아바타, 생성일, account_status가 포함됩니다. 소개와 팔로워 수는 포함되지 않으므로, 필요하면 반환된 사용자 이름으로 profile을 호출해야 합니다.
user_ids필수profiles_by_ids에 사용할 숫자 X 사용자 ID 1~20개로, 목록 또는 쉼표로 구분한 문자열로 전달합니다(예:44196397,11348282).
X (Twitter) user_about 파라미터는 각각 무엇을 의미하나요?
username으로 X(Twitter) 사용자의 '이 계정 정보' 페이지를 읽습니다. 계정 기반 국가와 그 정확성 여부, 가입 경로, 사용자 이름 변경 횟수와 마지막 변경 시점, 인증 시작 시점이 포함됩니다. 국가, 가입 경로, 마지막 변경 시점은 X에 표시되는 경우에만 제공됩니다.
username필수- 조회할 계정입니다(예:
NASA). 앞의 @는 제거됩니다.
X (Twitter) check_follow 파라미터는 각각 무엇을 의미하나요?
X(Twitter) 계정 하나가 다른 계정을 팔로우하는지 확인합니다. 팔로워일 수 있는 계정을 username에, 확인할 대상 계정을 target_username에 전달하면 is_following이 true 또는 false로 반환됩니다. 결과는 호출 시점의 관계를 반영합니다.
username필수- 팔로우하고 있는지 확인할 계정입니다(예:
NASA). 앞의 @는 제거됩니다. target_username필수check_follow가 확인할 대상 계정으로,username이 이 계정을 팔로우하는지 확인합니다. 예를 들어NASAHubble처럼 입력하며, 앞의 @는 제거됩니다.
X (Twitter) check_retweet 파라미터는 각각 무엇을 의미하나요?
X(Twitter) 계정이 특정 게시물을 리포스트했는지 확인합니다. username에 계정을, id에 게시물의 숫자 ID를 전달하면 is_retweeted가 true 또는 false로 반환됩니다. 결과는 호출 시점에 X에 표시되는 리포스트를 반영합니다.
username필수- 확인할 계정입니다(예:
NASA). 앞의 @는 제거됩니다. id필수- 게시물의 숫자 ID로, 링크에서 /status/ 뒤에 오는 숫자입니다. 문자열로 유지해야 합니다.
url선택- 호환용 입력으로, 게시물 링크 https://x.com/<username>/status/<ID>를 받습니다.
id가 우선합니다.
X (Twitter) community_info 파라미터는 각각 무엇을 의미하나요?
숫자 community_id로 X(Twitter) 커뮤니티 하나를 읽어 옵니다. 이름, 설명, 주제, 멤버 수, NSFW 플래그, 배너, 생성일, 규칙을 받을 수 있습니다.
community_id필수community_info와community_posts에 사용할 숫자 Community ID로, 링크에서 /i/communities/ 뒤의 숫자입니다(예:1508567430188126209).url선택- 호환용 입력으로, 커뮤니티 링크 https://x.com/i/communities/<ID>를 받습니다.
community_id가 우선합니다.
X (Twitter) search_communities 파라미터는 각각 무엇을 의미하나요?
keyword로 X(Twitter) 커뮤니티를 검색합니다. 각 커뮤니티에는 ID, 링크, 이름, 주제, 멤버 수, NSFW 여부, 배너가 포함됩니다. 페이지당 약 10개이며, next_page_token으로 다음 페이지를 가져옵니다.
keyword필수- 커뮤니티 이름과 주제에서 검색할 단어입니다(예:
crypto,photography). page_token선택user_media,user_replies,retweeters,search_communities,community_posts,search_users의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
X (Twitter) search_users 파라미터는 각각 무엇을 의미하나요?
사용자 탭과 같은 방식으로 keyword로 X(Twitter) 계정을 검색하며, 사용자 이름, 표시 이름, 소개에서 일치 항목을 찾습니다. 각 계정에는 소개, 아바타, 팔로워·팔로잉·게시물 수, 인증 여부, 생성일이 포함됩니다. 페이지당 약 20개이며, next_page_token으로 다음 페이지를 가져옵니다. 게시물은 반환되지 않습니다.
keyword필수- 계정을 찾을 주제, 이름 또는 사용자 이름입니다(예:
ai agents). 게시물이 아닌 계정을 반환합니다. page_token선택user_media,user_replies,retweeters,search_communities,community_posts,search_users의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.
X (Twitter) video_transcript 파라미터는 각각 무엇을 의미하나요?
게시물 링크나 ID로 X(Twitter) 동영상 게시물의 음성을 텍스트로 변환합니다. 게시물 ID, 링크, text에 담긴 전체 스크립트, word_count가 반환됩니다. 구간별 타임스탬프는 없습니다. 동영상이 없는 게시물이나 말소리가 없는 동영상은 빈 결과를 반환합니다.
url필수- 동영상 게시물 링크(https://x.com/<username>/status/<ID>) 또는 숫자 게시물 ID입니다.
id선택- 호환용 입력으로, 숫자 게시물 ID를 받습니다.
url이 우선합니다.
X (Twitter) thread 파라미터는 각각 무엇을 의미하나요?
X(Twitter) 게시물 링크 하나를 전달하면 작성자가 올린 스레드 전체를 첫 게시물부터 최대 100개까지 가져옵니다. 각 게시물에는 텍스트, 미디어, 참여 수치, 게시 시각, 작성자 정보가 포함됩니다. 다른 계정의 답글은 포함되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- 스레드에 속한 아무 게시물의 링크(https://x.com/<username>/status/<ID>) 또는 숫자 게시물 ID입니다.
id선택- 호환용 입력으로, 숫자 게시물 ID를 받습니다.
url이 우선합니다.
X (Twitter) community_posts 파라미터는 각각 무엇을 의미하나요?
숫자 community_id로 X(Twitter) 커뮤니티 하나의 최신 게시물을 읽습니다. 각 게시물에는 텍스트, 미디어, 참여 수치, 게시 시각, 작성자의 사용자 이름과 인증 여부가 포함됩니다. 페이지당 약 20개이며, next_page_token으로 다음 페이지를 가져옵니다.
community_id필수community_info와community_posts에 사용할 숫자 Community ID로, 링크에서 /i/communities/ 뒤의 숫자입니다(예:1508567430188126209).page_token선택user_media,user_replies,retweeters,search_communities,community_posts,search_users의 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의next_page_token을 받은 그대로 전달하세요. 마지막 페이지에는 토큰이 없습니다.url선택- 호환용 입력으로, 커뮤니티 링크 https://x.com/i/communities/<ID>를 받습니다.
community_id가 우선합니다.
X (Twitter) API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"twitter","action":"search","params":{"keyword":"<keyword>"}}'
X (Twitter) 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
멀티 플랫폼 평판 모니터링 설계도: 부정 여론의 변화를 평가하기 전에 범위부터 정의하기
대상 목록, 댓글 식별자, 증분 커서에서 출발해 추적 가능한 평판 모니터링 워크플로를 설계하고, 오프라인 샘플로 중복 제거와 수집 누락을 보여 주며, 사람의 검토 단계를 유지합니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기X (Twitter) API 자주 묻는 질문
X (Twitter) API로 무엇을 가져올 수 있나요?
platform을 twitter 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 프로필, 사용자 게시물, 게시물 상세 정보, 댓글 및 more입니다. 각 액션 이름은 서로 다른 X (Twitter) 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
X (Twitter)에 공식 API가 있나요?
네. X API v2는 X Developer Console을 통해 모든 개발자가 이용할 수 있습니다. 2026년 2월부터는 사용량 기반 종량제로 과금되며, 크레딧을 구매한 뒤 리소스별로 비용을 지불합니다. 예를 들어 게시물 읽기는 건당 $0.005, 사용자 정보 읽기는 건당 $0.010이며, 게시물 읽기는 월 3백만 건까지 가능하고 이를 넘으면 Enterprise 요금제가 필요합니다(2026년 10월 공개된 가격 기준).
공식 출처: X API pricing · X API: getting access · 확인일
X (Twitter) 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. X (Twitter) 개발자 앱을 등록하거나, X (Twitter) API 접근을 신청하거나, X (Twitter) 계정으로 로그인할 필요가 없으며, 액션은 공개된 X (Twitter) 데이터만 반환합니다.
X (Twitter) API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $0.56부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
X (Twitter) search 요청에는 어떤 입력이 필요한가요?
X 게시물 검색어이며, from:이나 since: 같은 플랫폼 검색 연산자를 포함할 수 있습니다. 정렬은 sort를 참고하세요. params 안의 keyword 필드로 전달하세요.
X (Twitter) search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 text, like_count, retweet_count 및 reply_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 X (Twitter) 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.