플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Threads 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드를 언급한 Threads 게시물을 가져오며, 각 게시물의 본문, 작성자, 좋아요 수와 댓글 수, 게시 시각을 제공합니다. | 요청 1,000개당 $0.56 | 정상 |
프로필profile | 핸들로 Threads 계정을 확인합니다. | 요청 1,000개당 $0.56 | 정상 |
사용자 게시물user_posts | Threads 계정의 게시물을 좋아요·댓글·리포스트·인용·공유·조회 수를 각각 구분해 나열하며, 해시태그와 멘션도 제공합니다. | 요청 1,000개당 $0.56 | 정상 |
게시물 상세 정보post_detail | 전체 URL로 Threads 게시물 하나를 읽어 옵니다. | 요청 1,000개당 $0.56 | 정상 |
댓글comments | Threads 게시물의 답글을 수집합니다. | 요청 1,000개당 $0.56 | 정상 |
프로필 탐색discover_profiles | 키워드와 관련된 Threads 크리에이터 프로필을 찾습니다. | 요청 1,000개당 $0.56 | 정상 |
팔로워followers | Threads 계정의 팔로워·팔로잉·게시물·좋아요 수를 가져오며, 반올림된 수치를 표시하는 precision 플래그가 함께 제공됩니다. | 요청 1,000개당 $0.56 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Threads 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드를 언급한 Threads 게시물을 가져오며, 각 게시물의 본문, 작성자, 좋아요 수와 댓글 수, 게시 시각을 제공합니다. 이름으로 프로필을 조회하지는 않으며, 전체 기록이나 실시간 수집을 보장하지 않습니다. | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=15, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · text · author_name · author_username · author_id · like_count · comment_count · posted_at · author_is_verified · media · hashtags · mentions · links · platform |
profile프로필 핸들로 Threads 계정을 확인합니다. 표시 이름, 소개, 팔로워 수, 외부 링크, 인증 및 비공개 플래그를 받을 수 있습니다. 프로필 URL이 아닌 핸들을 @ 포함 여부와 관계없이 전달하세요. 비공개 프로필은 열리지 않습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $0.56 | user_id · username · display_name · bio · follower_count · is_verified · is_private · url · avatar_url · platform · external_url |
user_posts사용자 게시물 Threads 계정의 게시물을 좋아요·댓글·리포스트·인용·공유·조회 수를 각각 구분해 나열하며, 해시태그와 멘션도 제공합니다. 프로필 URL이 아닌 핸들을 전달하세요. 한 번에 전체 기록을 가져오지 못할 수 있으며, 계정이 작성한 답글은 제외됩니다. | username | — | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · platform · media_type · hashtags · mentions |
post_detail게시물 상세 정보 전체 URL로 Threads 게시물 하나를 읽어 옵니다. 본문, 작성자, 반응 수, 해시태그, 미디어, 유료 파트너십 플래그를 받을 수 있습니다. 해당 게시물만 반환하며 주변 스레드 전체는 포함되지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.56 | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · is_paid_partnership · author_id · author_avatar_url · image_count · image_urls · platform · media_url · hashtags |
comments댓글 Threads 게시물의 답글을 수집합니다. 각 답글에는 본문, 작성자, 인증 여부, 좋아요 수, 응답 대상이 포함됩니다. 전체 게시물 URL을 전달하세요. 중첩 답글은 모두 반환되지 않을 수 있습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.56 | id · url · text · author_username · author_name · author_is_verified · like_count · comment_count · reply_to · posted_at · platform |
discover_profiles프로필 탐색 키워드와 관련된 Threads 크리에이터 프로필을 찾습니다. 소개, 팔로워 수, 인증 여부, 외부 링크, 그리고 기재된 이메일이나 전화번호를 받을 수 있습니다. 비동기 작업으로 실행되므로 첫 상태 응답이 아니라 완료된 결과를 읽으세요. 일치한다고 해서 신원이나 적합성이 입증되지는 않습니다. | keyword | since, until | Async 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | username · display_name · bio · follower_count · is_verified · url · avatar_url · platform · emails · phones · external_links |
followers팔로워 Threads 계정의 팔로워·팔로잉·게시물·좋아요 수를 가져오며, 반올림된 수치를 표시하는 | username | channel | Sync 응답 | — | 요청 1,000개당 $0.56 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
Threads search 파라미터는 각각 무엇을 의미하나요?
키워드를 언급한 Threads 게시물을 가져오며, 각 게시물의 본문, 작성자, 좋아요 수와 댓글 수, 게시 시각을 제공합니다. 이름으로 프로필을 조회하지는 않으며, 전체 기록이나 실시간 수집을 보장하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- search로 공개 게시물을, discover_profiles로 크리에이터 프로필을 찾을 검색어를 지정합니다. discover_profiles 액션은 비동기로 동작하므로 처음 받는 작업 상태 응답을 최종 크리에이터 목록으로 파싱하면 안 됩니다.Meta 공식 문서: Threads 키워드 탐색과 참여 지표 — Meta 공식 자료는 검색 키워드를 이용한 공개 게시물 탐색을 정의하고, 답글, 리포스트, 인용, 외부 공유를 구분합니다. 이는 Threads의 제품 객체와 용어를 정의할 뿐이며, 이 API 엔드포인트가 공식 필터링, 쓰기, 분석 기능을 모두 지원한다는 의미는 아닙니다. · 확인일
Threads profile 파라미터는 각각 무엇을 의미하나요?
핸들로 Threads 계정을 확인합니다. 표시 이름, 소개, 팔로워 수, 외부 링크, 인증 및 비공개 플래그를 받을 수 있습니다. 프로필 URL이 아닌 핸들을 @ 포함 여부와 관계없이 전달하세요. 비공개 프로필은 열리지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- profile, user_posts, followers 액션에 사용할 Threads 핸들을 지정합니다(@는 붙여도 되고 생략해도 됨). profile과 user_posts 액션은 프로필 전체 URL을 받지 않습니다. followers 액션은 사용자 목록이 아니라 전체 팔로워 수를 반환합니다.Meta 공식 문서: Threads 프로필, 팔로워 수, 접근 제약 — Meta 공식 자료는 `username`, 표시 이름, 소개, `follower_count`를 정의하며, 공개 프로필 탐색에는 특정 권한이 필요하고 표준 접근은 일부 공식 계정으로 제한되며 공개 계정 및 팔로워 수 기준이 적용된다고 설명합니다. 여기서는 플랫폼 용어를 설명하기 위해서만 인용하며, 이 API가 해당 권한을 보유하거나 공식 엔드포인트와 같은 기능을 제공한다는 의미는 아닙니다. · 확인일
Threads user_posts 파라미터는 각각 무엇을 의미하나요?
Threads 계정의 게시물을 좋아요·댓글·리포스트·인용·공유·조회 수를 각각 구분해 나열하며, 해시태그와 멘션도 제공합니다. 프로필 URL이 아닌 핸들을 전달하세요. 한 번에 전체 기록을 가져오지 못할 수 있으며, 계정이 작성한 답글은 제외됩니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- profile, user_posts, followers 액션에 사용할 Threads 핸들을 지정합니다(@는 붙여도 되고 생략해도 됨). profile과 user_posts 액션은 프로필 전체 URL을 받지 않습니다. followers 액션은 사용자 목록이 아니라 전체 팔로워 수를 반환합니다.Meta 공식 문서: 사용자 이름으로 Threads 게시물 찾기 — Meta 공식 자료는 사용자 프로필 엔드포인트와 사용자 게시물 엔드포인트를 구분하고, `profile_posts`가 정확한 사용자 이름으로 게시물을 찾는 방식을 설명하며 `id`, `shortcode`, `permalink` 등 별도의 필드를 나열합니다. 공식 `access_token`, 페이지네이션, 날짜 파라미터를 이 API 엔드포인트가 지원한다고 가정해서는 안 됩니다. · 확인일
Threads post_detail 파라미터는 각각 무엇을 의미하나요?
전체 URL로 Threads 게시물 하나를 읽어 옵니다. 본문, 작성자, 반응 수, 해시태그, 미디어, 유료 파트너십 플래그를 받을 수 있습니다. 해당 게시물만 반환하며 주변 스레드 전체는 포함되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- post_detail과 comments 액션에 사용할 게시물 전체 URL(예: https://www.threads.com/@username/post/POST_CODE)을 지정합니다. comments 액션은 모든 중첩 댓글 스레드의 추출을 보장하지 않습니다.Meta 공식 문서: Threads 리포스트, 인용, 외부 공유 — Meta 공식 자료는 리포스트, 인용, 공유를 구분하며, 공유는 플랫폼 외부로의 공유로 정의합니다. 이는 원본 게시물의 참여 지표를 명확히 하지만, 모든 응답에 모든 지표가 포함되거나 게시 액션이 지원된다는 보장은 아닙니다. · 확인일
Threads comments 파라미터는 각각 무엇을 의미하나요?
Threads 게시물의 답글을 수집합니다. 각 답글에는 본문, 작성자, 인증 여부, 좋아요 수, 응답 대상이 포함됩니다. 전체 게시물 URL을 전달하세요. 중첩 답글은 모두 반환되지 않을 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- post_detail과 comments 액션에 사용할 게시물 전체 URL(예: https://www.threads.com/@username/post/POST_CODE)을 지정합니다. comments 액션은 모든 중첩 댓글 스레드의 추출을 보장하지 않습니다.Meta 공식 문서: 최상위 답글과 전체 대화 트리는 다르다 — Meta 공식 자료는 최상위 답글과 깊이 제한 없는 전체 대화를 구분하며, `replied_to`를 직계 상위 콘텐츠 ID로 정의합니다. 이 API에서 `reply_to`는 공식 `replied_to` 필드가 아니라 답글 대상 사용자 이름을 나타내며, 전체 댓글 트리를 보장하지 않습니다. 공식 공개 범위와 저작권 제한으로 인해 일부 필드가 누락될 수도 있습니다. · 확인일Meta 공식 문서: Threads 답글을 읽으려면 권한이 필요하다 — 답글 관리에 관한 Meta 공식 문서는 계정 소유자 본인의 Threads 게시물을 대상으로 하며, 적절한 액세스 토큰과 읽기 권한이 필요합니다. 이를 인용한다고 해서 임의의 제3자 게시물에 대한 접근이 보장되거나 이 제품이 플랫폼 허가를 받았다는 증거가 되지는 않습니다. · 확인일
Threads discover_profiles 파라미터는 각각 무엇을 의미하나요?
키워드와 관련된 Threads 크리에이터 프로필을 찾습니다. 소개, 팔로워 수, 인증 여부, 외부 링크, 그리고 기재된 이메일이나 전화번호를 받을 수 있습니다. 비동기 작업으로 실행되므로 첫 상태 응답이 아니라 완료된 결과를 읽으세요. 일치한다고 해서 신원이나 적합성이 입증되지는 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- search로 공개 게시물을, discover_profiles로 크리에이터 프로필을 찾을 검색어를 지정합니다. discover_profiles 액션은 비동기로 동작하므로 처음 받는 작업 상태 응답을 최종 크리에이터 목록으로 파싱하면 안 됩니다.Meta 공식 문서: 공개 프로필 탐색은 정확한 키워드 사용자 검색이 아니다 — Meta 공식 `profile_lookup`은 정확한 사용자 이름이 필요하며 권한, 접근 수준, 계정 자격 요건의 적용을 받습니다. 이 API의 키워드 기반 후보 프로필 탐색을 공식 API의 정확한 사용자 이름 조회와 동일하게 취급해서는 안 되며, 공식 문서가 모든 사용자에 대한 커버리지를 보장하는 것도 아닙니다. · 확인일
since선택- discover_profiles에 사용하는 공유 날짜 하한 파라미터입니다. 발견된 프로필이 필터링된다고 보장하지 않으며, 계정 생성일로 필터링하지 않습니다.
until선택- discover_profiles에 사용하는 공유 날짜 상한 파라미터입니다. 해당 기간의 크리에이터를 모두 포함한다고 보장하지 않으며, search에는 날짜 필터가 없습니다.
Threads followers 파라미터는 각각 무엇을 의미하나요?
Threads 계정의 팔로워·팔로잉·게시물·좋아요 수를 가져오며, 반올림된 수치를 표시하는 precision 플래그가 함께 제공됩니다. 수치만 반환하며, 팔로워 목록이나 시간에 따른 추이는 포함되지 않습니다.
username필수- profile, user_posts, followers 액션에 사용할 Threads 핸들을 지정합니다(@는 붙여도 되고 생략해도 됨). profile과 user_posts 액션은 프로필 전체 URL을 받지 않습니다. followers 액션은 사용자 목록이 아니라 전체 팔로워 수를 반환합니다.Meta 공식 문서: Threads 프로필, 팔로워 수, 접근 제약 — Meta 공식 자료는 `username`, 표시 이름, 소개, `follower_count`를 정의하며, 공개 프로필 탐색에는 특정 권한이 필요하고 표준 접근은 일부 공식 계정으로 제한되며 공개 계정 및 팔로워 수 기준이 적용된다고 설명합니다. 여기서는 플랫폼 용어를 설명하기 위해서만 인용하며, 이 API가 해당 권한을 보유하거나 공식 엔드포인트와 같은 기능을 제공한다는 의미는 아닙니다. · 확인일
channel선택- followers 액션에서 계정 핸들을 지정하는 호환용 대체 입력입니다. username보다 우선순위가 낮으며, 채널이나 그룹 멤버 목록이 아니라 팔로워 수를 반환합니다.
Threads 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":"threads","action":"search","params":{"keyword":"<keyword>"}}'
Threads 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
멀티 플랫폼 평판 모니터링 설계도: 부정 여론의 변화를 평가하기 전에 범위부터 정의하기
대상 목록, 댓글 식별자, 증분 커서에서 출발해 추적 가능한 평판 모니터링 워크플로를 설계하고, 오프라인 샘플로 중복 제거와 수집 누락을 보여 주며, 사람의 검토 단계를 유지합니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기Threads API 자주 묻는 질문
Threads API로 무엇을 가져올 수 있나요?
platform을 threads 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 프로필, 사용자 게시물, 게시물 상세 정보, 댓글 및 more입니다. 각 액션 이름은 서로 다른 Threads 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Threads에 공식 API가 있나요?
네. Meta의 Threads API는 사용자가 자신의 Threads 게시물을 게시하고 관리하도록 만들어졌습니다. 키워드로 공개 게시물을 검색하거나 공개 프로필을 조회하려면 threads_keyword_search와 threads_profile_discovery 권한이 필요합니다. 이 권한은 Meta 앱 검수를 거쳐야 하며, 사용자당 24시간마다 검색 2,200회, 프로필 조회 1,000회로 제한됩니다.
공식 출처: Meta: Threads keyword search · Meta: Threads API overview · 확인일
Threads 개발자 계정이나 API 키가 필요한가요?
아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. Threads 개발자 앱을 등록하거나, Threads API 접근을 신청하거나, Threads 계정으로 로그인할 필요가 없으며, 액션은 공개된 Threads 데이터만 반환합니다.
Threads API 요금은 요청 1,000건당 얼마인가요?
액션에 따라 요청 1,000개당 $0.56이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.
Threads search 요청에는 어떤 입력이 필요한가요?
search로 공개 게시물을, discover_profiles로 크리에이터 프로필을 찾을 검색어를 지정합니다. discover_profiles 액션은 비동기로 동작하므로 처음 받는 작업 상태 응답을 최종 크리에이터 목록으로 파싱하면 안 됩니다. params 안의 keyword 필드로 전달하세요.
Threads search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 text, author_name, author_username 및 author_id입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Threads 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답 및 async 응답입니다.