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

요청

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

동작

username은 사용자 이름이나 프로필 URL을 받습니다. postUrl은 https://www.instagram.com/p/Df147tCiAyB/ 같은 게시물, 릴스, IGTV URL을 받습니다.

입력

  • query: search에 필수. 키워드, 해시태그 단어, 브랜드 이름입니다.
  • limit: 선택. search는 1-30이며 기본값은 10입니다. posts는 1-12이며 기본값은 12입니다. comments는 1-500이며 기본값은 50입니다.

응답 예시

결과 필드

  • 모든 응답은 platform과 action을 그대로 돌려줍니다. 목록에는 returnedCount가 있습니다.
  • profile은 id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, followingCount, postCount, hasReels, highlights, threadsUsername, pronouns, recentPosts를 돌려줍니다. 계정에 스토리가 올라와 있는 동안 latestStoryAt이 나타나고, isMemorialized는 추모 계정을 표시합니다.
  • posts는 posts를 돌려줍니다. 계정의 최근 게시물 12개이며, 각 게시물 페이지에서 읽은 likeCount, commentCount, publishedAt이 있습니다.
  • post는 post와 게시물의 첫 comments를 돌려줍니다. 게시물에는 id, code, url, mediaType(image, video, carousel), caption, imageUrl, images, videoUrl, width, height, likeCount, commentCount, publishedAt, username, authorFullName, authorIsVerified, authorProfileImageUrl, coauthors, taggedUsers, topics, audio(노래나 작성자의 오리지널 오디오), hasAudio, captionIsEdited, aiLabel, commentsDisabled가 있습니다.
  • comments는 comments를 돌려줍니다. 각 댓글에는 id, text, username, likeCount, replyCount, publishedAt이 있습니다. GIF 댓글에는 gifUrl이 붙습니다. availableCount는 게시물의 댓글 수이고, partial: true는 목록이 그 수보다 짧다는 뜻입니다.
  • search는 posts를 돌려줍니다. 각 게시물에는 position, 작성자의 username, authorId, authorIsVerified, authorProfileImageUrl이 있고, 릴스에는 playCount가 있습니다. Instagram에 키워드 검색 페이지가 있으면 source가 instagram이고, 그 페이지의 title, relatedKeywords, 키워드에 대한 Instagram의 summary와 각주 번호가 가리키는 sources가 더해집니다. 다른 키워드는 source가 web이고, posts에 최근 30일의 공개 게시물과 릴스가 담깁니다.
  • Instagram은 로그아웃한 방문자에게 프로필의 최근 게시물 12개와 게시물 댓글 10여 개를 보여 주며, posts, post, comments가 그만큼을 돌려줍니다. 검색 결과의 수치와 게시 시각은 post로 읽습니다.
  • 없는 계정이나 게시물, 비공개 게시물, Instagram이 로그인한 방문자에게만 보여 주는 페이지는 task를 PAGE_UNAVAILABLE로 끝냅니다. 완료된 요청만 과금합니다.

관련 문서