taskType SOCIAL에 platform instagram을 보내고 action으로 읽을 대상을 고릅니다. 완료된 요청당 0.5크레딧입니다.
요청
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로 끝냅니다. 완료된 요청만 과금합니다.