메인 콘텐츠로 건너뛰기
공개 Threads 데이터를 비동기 task API로 JSON으로 읽습니다. taskType SOCIAL에 platform threads를 보내고 action으로 읽을 대상을 고릅니다. 완료된 요청당 0.5크레딧입니다.

요청

task를 제출한 뒤 GET /v1/async/task/{id}를 폴링하거나 웹훅으로 받습니다. 참고: 비동기 task.

동작

username은 사용자 이름이나 프로필 URL을 받습니다. postUrl은 https://www.threads.com/@natgeo/post/Dfzi22JJSYp 같은 게시물 URL을 받습니다.

입력

  • query: search에 필수입니다.
  • limit: 선택. search와 profile은 1-50이며 기본값은 10입니다. replies는 1-500이며 기본값은 50입니다.

응답 예시

결과 필드

  • 모든 응답은 platform과 action을 그대로 돌려줍니다. 목록에는 returnedCount가 있습니다.
  • 게시물에는 id, code, url, text, author, authorVerified, publishedAt, mediaType(text, image, video, carousel), images, videoUrl, likeCount, replyCount, repostCount, quoteCount, shareCount, isReply가 있습니다. 답글에는 답한 상대의 사용자 이름인 replyTo가 더해집니다.
  • search는 Threads가 보여 주는 순서대로 posts를 최대 50개 정도 돌려줍니다.
  • profile은 id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, threadCount, recentPosts를 돌려줍니다. recentPosts는 프로필 페이지에 보이는 최근 게시물 4-13개입니다.
  • post는 post를 돌려줍니다. replies는 replies를 돌려주며 게시물당 10개 정도입니다. availableCount는 게시물의 답글 수이고, partial: true는 작성자가 답글을 숨긴 경우처럼 목록이 그 수보다 짧다는 뜻입니다.
  • 없거나 공개되지 않은 프로필이나 게시물은 task를 PAGE_UNAVAILABLE로 끝냅니다. 완료된 요청만 과금합니다.

관련 문서