자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

Instagram API

계정 핸들, 미디어 URL 또는 해시태그로 Instagram 게시물, 릴스, 댓글, 공개 프로필 정보를 가져옵니다.

게시물의 전체 URL로 게시물 하나를 가져옵니다. 팔로워 수와 팔로워·팔로잉 목록은 별도로 조회해야 합니다.

플랫폼 가용성

24시간 상태
85%
사용 가능

최근 30일

제공 기능

각 Instagram 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.

기능설명1,000건당24시간 상태
게시물 상세 정보posturls의 링크로 Instagram 게시물이나 릴스를 하나 이상 가져옵니다.요청 1,000개당 $0.56정상
프로필profile핸들이나 프로필 URL로 Instagram 계정을 조회합니다.요청 1,000개당 $0.56양호 · 상태 100%
계정 인사이트persona공개 프로필을 바탕으로 Instagram 핸들의 계정 개요를 가져옵니다.요청 1,000개당 $0.56정상
사용자 게시물user_postsusername으로 Instagram 계정의 게시물을 나열하며, 게시물별 캡션, 미디어 유형, 좋아요·댓글·조회수, 위치, 해시태그, 상위 댓글을 포함합니다.요청 1,000개당 $0.56정상
콘텐츠 탐색discoverkeyword에 전달한 Instagram 해시태그의 게시물을 추적합니다.요청 1,000개당 $0.56정상
댓글commentsurl의 Instagram 게시물이나 릴스 하나에 달린 댓글을 조회합니다.요청 1,000개당 $0.56대부분 작동 중단 · 상태 4%
릴스reelsusername으로 Instagram 계정의 릴스를 가져오며, 캡션, 재생 수, 초 단위 길이, 좋아요 수, 댓글 수, 해시태그, 음악, 동영상 링크를 포함합니다.요청 1,000개당 $1.19일시적으로 사용 불가
해시태그hashtaghashtag에 # 기호 없이 넣은 Instagram 해시태그의 게시물을 수집합니다.요청 1,000개당 $0.56정상
팔로워followersusername으로 Instagram 계정의 팔로워 수와 팔로잉 수를 확인합니다.요청 1,000개당 $0.56정상
팔로워 목록followers_listusername으로 Instagram 사용자를 팔로우하는 계정을 나열하며, 핸들, 이름, 프로필 사진, 비공개 및 인증 플래그, 관계 유형을 포함합니다.요청 1,000개당 $0.56정상
팔로잉 목록following_listusername으로 Instagram 사용자가 팔로우하는 계정을 나열하며, 핸들, 이름, 프로필 사진, 비공개 및 인증 플래그, 관계 유형을 포함합니다.요청 1,000개당 $0.56정상
계정 검색user_searchkeyword로 Instagram 계정을 검색하며, 결과는 Instagram 검색이 해당 단어에 매긴 순서를 따릅니다.요청 1,000개당 $4.81사용 가능 · 상태 75%
릴스 검색reels_searchcoffee 같은 keyword로 Instagram 릴스를 검색합니다.요청 1,000개당 $7.19정상
유사 계정similar_profilesnasa 같은 username으로 Instagram이 해당 계정과 유사하다고 추천하는 계정을 찾습니다.요청 1,000개당 $8.81정상
태그된 게시물tagged_postsusername, 프로필 URL, 숫자 사용자 ID로 지정한 Instagram 계정을 태그한 다른 계정의 공개 게시물을 나열합니다.요청 1,000개당 $7.44정상
스토리stories사용자 이름으로 Instagram 계정에 현재 게시 중인 스토리를 가져옵니다.요청 1,000개당 $1.5정상
스토리 하이라이트highlightsInstagram 프로필의 스토리 하이라이트를 나열합니다.요청 1,000개당 $1.6정상
댓글 답글comment_replies게시물 링크와 comments에서 반환된 댓글 id로 Instagram 게시물이나 릴스의 댓글 하나에 달린 답글을 조회합니다.요청 1,000개당 $0.88정상

기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.

Instagram 액션별로 어떤 입력을 받나요?

아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.

공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.

액션필수선택전달 방식한도1,000건당응답 필드
post

게시물 상세 정보

urls의 링크로 Instagram 게시물이나 릴스를 하나 이상 가져옵니다. 캡션, 미디어 유형, 좋아요·댓글·조회수, 작성자 팔로워 수, 해시태그, 상위 댓글 몇 개가 포함됩니다. 비공개 콘텐츠는 가져오지 않습니다. 사진이나 동영상에 대한 권한은 부여되지 않습니다.

urls—Sync 응답카탈로그 값: defaultLimit=11, maxLimit=11. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments
profile

프로필

핸들이나 프로필 URL로 Instagram 계정을 조회합니다. 표시 이름, 소개, 팔로워·팔로잉·게시물 수, 계정 유형 플래그, 외부 링크, 최근 게시물을 가져옵니다. 인증, 비즈니스, 프로페셔널 플래그는 신원, 소득, 현재 상업 활동을 입증하지 않습니다.

username—Sync 응답—요청 1,000개당 $0.56username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · user_id · avatar_hd_url · external_urls · has_reels · highlight_count · recent_posts
persona

계정 인사이트

공개 프로필을 바탕으로 Instagram 핸들의 계정 개요를 가져옵니다. 소개, 카테고리, 팔로워 및 게시물 수, 계정 유형 플래그, 최근 게시물이 포함됩니다. 응답에는 나이, 성별, 관심사, 구매자 정보나 기타 특성이 포함되지 않으며, 이를 추론하지도 않습니다.

username—Sync 응답—요청 1,000개당 $0.56username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url · user_id · avatar_hd_url · external_urls · has_reels · highlight_count · recent_posts
user_posts

사용자 게시물

username으로 Instagram 계정의 게시물을 나열하며, 게시물별 캡션, 미디어 유형, 좋아요·댓글·조회수, 위치, 해시태그, 상위 댓글을 포함합니다. 전체 기록을 보장하지 않으며, 비공개 스토리와 내부 도달 데이터는 포함되지 않습니다.

username—Async 응답카탈로그 값: defaultLimit=30, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments
discover

콘텐츠 탐색

keyword에 전달한 Instagram 해시태그의 게시물을 추적합니다. 캡션, 미디어 유형, 참여 수치, 작성자 팔로워 수, 위치, 게시 시간을 가져옵니다. 짧은 동영상은 results_type을 reels로 설정하세요. 결과로 탐색 탭 순위 방식을 설명하거나 트렌드를 입증할 수는 없습니다.

keywordresults_typeAsync 응답카탈로그 값: defaultLimit=30, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments
comments

댓글

url의 Instagram 게시물이나 릴스 하나에 달린 댓글을 조회합니다. 댓글별 본문, 작성자, 인증 배지, 좋아요 수, 답글 수, 작성 시간이 포함됩니다. 프로필 링크는 지원하지 않으며, 전체 대화 트리를 보장하지 않습니다.

url—Sync 응답카탈로그 값: defaultLimit=50, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56id · text · url · like_count · reply_count · author_username · author_name · is_verified · posted_at · post_url · platform
reels

릴스

username으로 Instagram 계정의 릴스를 가져오며, 캡션, 재생 수, 초 단위 길이, 좋아요 수, 댓글 수, 해시태그, 음악, 동영상 링크를 포함합니다. 자막 스크립트, 상위 댓글, 비공개 지표는 포함되지 않습니다.

username—Sync 응답카탈로그 값: defaultLimit=30, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $1.19post_id · url · text · media_type · like_count · comment_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · hashtags · play_count · duration_sec · duration_seconds · music · platform
hashtag

해시태그

hashtag에 # 기호 없이 넣은 Instagram 해시태그의 게시물을 수집합니다. 캡션, 미디어 유형, 좋아요·댓글·조회수, 작성자, 게시 시간을 가져옵니다. 짧은 동영상은 results_type에 reels를 전달하세요. 샘플만으로는 트렌드의 전체 규모를 측정할 수 없습니다.

hashtagresults_type, tagSync 응답카탈로그 값: defaultLimit=30, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location · id · image_url · video_url · author_id · width · height · is_comments_disabled · author_follower_count · hashtags · top_comments · platform
followers

팔로워

username으로 Instagram 계정의 팔로워 수와 팔로잉 수를 확인합니다. ID, 표시 이름, 프로필 사진, 프로필 링크도 가져옵니다. 팔로워가 누구인지가 아닌 총계를 반환합니다. 계정 목록은 followers_list에서 확인하세요.

username—Sync 응답—요청 1,000개당 $0.56id · username · url · name · avatar_url · follower_count · following_count · platform
followers_list

팔로워 목록

username으로 Instagram 사용자를 팔로우하는 계정을 나열하며, 핸들, 이름, 프로필 사진, 비공개 및 인증 플래그, 관계 유형을 포함합니다. 목록은 일부만 포함될 수 있으며 자동 연락 기능은 제공하지 않습니다.

username—Sync 응답카탈로그 값: defaultLimit=50, maxLimit=500. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform
following_list

팔로잉 목록

username으로 Instagram 사용자가 팔로우하는 계정을 나열하며, 핸들, 이름, 프로필 사진, 비공개 및 인증 플래그, 관계 유형을 포함합니다. 팔로우가 친밀도나 상호작용을 입증하지 않으며, 관계는 바뀔 수 있습니다.

username—Sync 응답카탈로그 값: defaultLimit=50, maxLimit=500. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform
user_search

계정 검색

keyword로 Instagram 계정을 검색하며, 결과는 Instagram 검색이 해당 단어에 매긴 순서를 따릅니다. 계정별 핸들, 이름, 팔로워·팔로잉·게시물 수, 소개, 외부 링크, 인증 및 비공개 플래그가 포함됩니다. 호출당 최대 30개, 기본 20개입니다. 게시물 본문이 아닌 계정을 검색합니다.

keyword—Async 응답카탈로그 값: defaultLimit=20, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $4.81rank · username · user_id · display_name · is_verified · is_private · url · avatar_url · follower_count · following_count · post_count · bio · external_url · platform
reels_search

릴스 검색

coffee 같은 keyword로 Instagram 릴스를 검색합니다. 릴스별 캡션, 재생 수, 좋아요 수, 댓글 수, 초 단위 길이, 작성자 핸들과 ID, 인증 배지, 게시 시간이 포함됩니다. 호출당 최대 200개, 기본 20개입니다. 순서는 Instagram 검색을 따르므로 결과는 해당 단어를 쓴 모든 릴스가 아닌 샘플입니다.

keyword—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $7.19post_id · id · url · text · play_count · like_count · comment_count · duration_sec · duration_seconds · author_username · author_id · is_verified · posted_at · platform
similar_profiles

유사 계정

nasa 같은 username으로 Instagram이 해당 계정과 유사하다고 추천하는 계정을 찾습니다. 계정별 팔로워·팔로잉·게시물 수, 소개, 외부 링크, 인증 및 비공개 플래그, 팔로워 수 기준 rank가 포함됩니다. 호출당 최대 30개, 기본 20개입니다. 유사 계정으로 추천되었다고 비즈니스 관계나 공통 오디언스가 입증되지는 않습니다.

username—Async 응답카탈로그 값: defaultLimit=20, maxLimit=30. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $8.81rank · username · user_id · display_name · is_verified · is_private · url · avatar_url · follower_count · following_count · post_count · bio · external_url · similar_to · platform
tagged_posts

태그된 게시물

username, 프로필 URL, 숫자 사용자 ID로 지정한 Instagram 계정을 태그한 다른 계정의 공개 게시물을 나열합니다. 게시물별 캡션, 좋아요 수, 댓글 수, 동영상 여부, 이미지 링크, 게시자 핸들과 ID, 게시 시간이 포함됩니다. 호출당 최대 200개, 기본 20개입니다. 비공개 계정의 게시물은 포함되지 않습니다.

username—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $7.44post_id · url · tagged_username · author_username · author_id · text · like_count · comment_count · is_video · posted_at · image_url · platform
stories

스토리

사용자 이름으로 Instagram 계정에 현재 게시 중인 스토리를 가져옵니다. 스토리별 미디어 링크, 사진 또는 동영상 유형, 동영상 길이, 게시 시간, 작성자의 이름·프로필 사진·인증 여부가 포함됩니다. 스토리는 24시간 동안 유지되므로 현재 게시 중인 스토리가 없는 계정은 빈 목록을 반환합니다.

username—Sync 응답카탈로그 값: defaultLimit=100, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $1.5id · url · media_url · media_type · duration_seconds · duration_sec · posted_at · author_username · author_name · author_avatar_url · author_is_verified · platform
highlights

스토리 하이라이트

Instagram 프로필의 스토리 하이라이트를 나열합니다. 하이라이트별 ID, 제목, 링크, 커버 이미지, 포함된 스토리 수, 생성 및 최종 업데이트 시점, 계정 ID와 이름이 포함됩니다. 하이라이트 안의 스토리는 반환되지 않으며, media_count, created_at, updated_at은 누락될 때가 있습니다.

username—Sync 응답카탈로그 값: defaultLimit=100, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $1.6id · url · title · media_count · cover_url · created_at · updated_at · is_pinned · author_username · author_id · author_name · platform
comment_replies

댓글 답글

게시물 링크와 comments에서 반환된 댓글 id로 Instagram 게시물이나 릴스의 댓글 하나에 달린 답글을 조회합니다. 답글별 본문, 좋아요 수, 작성 시간, 작성자의 사용자 이름·ID·프로필 사진·인증 여부가 포함됩니다. 페이지당 최대 10개이며 개수는 달라질 수 있고, next_page_token으로 다음 페이지를 가져옵니다.

url, comment_idpage_tokenSync 응답호출 한 번에 최대 10행의 한 페이지를 반환합니다. 페이지마다 행 수가 다르므로 행이 적다고 해서 마지막 페이지라는 뜻은 아닙니다. 다음 페이지를 가져오려면 응답 최상위의 next_page_token을 page_token으로 전달하고, 값이 없으면 중단하세요. limit은 허용되지만 효과가 없습니다.요청 1,000개당 $0.88id · text · like_count · posted_at · author_username · author_id · author_url · author_avatar_url · author_is_verified · reply_to_id · post_url · next_page_token · platform

Instagram post 파라미터는 각각 무엇을 의미하나요?

urls의 링크로 Instagram 게시물이나 릴스를 하나 이상 가져옵니다. 캡션, 미디어 유형, 좋아요·댓글·조회수, 작성자 팔로워 수, 해시태그, 상위 댓글 몇 개가 포함됩니다. 비공개 콘텐츠는 가져오지 않습니다. 사진이나 동영상에 대한 권한은 부여되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
urls필수
post 액션에서 Instagram 게시물 또는 릴스 전체 URL 배열(예: /p/<shortcode>/ 또는 /reel/<shortcode>/)을 받으며, 대상 URL별로 과금됩니다. post와 달리 comments 액션은 URL 하나만 처리합니다.
Instagram: 공개 게시물과 임베드의 경계 — Instagram에 따르면 비공개 계정의 콘텐츠는 임베드할 수 없으며, 공개 계정도 임베드를 끌 수 있습니다. 공유나 임베드가 가능하다고 해서 추가 데이터 접근 권한이 생기지는 않으며, 이 엔드포인트의 입력과 조회 가능 범위는 위 안내를 따릅니다. · 확인일

Instagram profile 파라미터는 각각 무엇을 의미하나요?

핸들이나 프로필 URL로 Instagram 계정을 조회합니다. 표시 이름, 소개, 팔로워·팔로잉·게시물 수, 계정 유형 플래그, 외부 링크, 최근 게시물을 가져옵니다. 인증, 비즈니스, 프로페셔널 플래그는 신원, 소득, 현재 상업 활동을 입증하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
@ 기호 없는 Instagram 계정 핸들 또는 프로필 전체 URL로 계정을 지정합니다. profile, persona, user_posts, reels에서 계정 데이터를 가져오는 데 사용합니다. followers 액션은 총 팔로워 수만 반환하고, followers_list와 following_list는 계정 목록을 반환합니다.

Instagram persona 파라미터는 각각 무엇을 의미하나요?

공개 프로필을 바탕으로 Instagram 핸들의 계정 개요를 가져옵니다. 소개, 카테고리, 팔로워 및 게시물 수, 계정 유형 플래그, 최근 게시물이 포함됩니다. 응답에는 나이, 성별, 관심사, 구매자 정보나 기타 특성이 포함되지 않으며, 이를 추론하지도 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
@ 기호 없는 Instagram 계정 핸들 또는 프로필 전체 URL로 계정을 지정합니다. profile, persona, user_posts, reels에서 계정 데이터를 가져오는 데 사용합니다. followers 액션은 총 팔로워 수만 반환하고, followers_list와 following_list는 계정 목록을 반환합니다.

Instagram user_posts 파라미터는 각각 무엇을 의미하나요?

username으로 Instagram 계정의 게시물을 나열하며, 게시물별 캡션, 미디어 유형, 좋아요·댓글·조회수, 위치, 해시태그, 상위 댓글을 포함합니다. 전체 기록을 보장하지 않으며, 비공개 스토리와 내부 도달 데이터는 포함되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
@ 기호 없는 Instagram 계정 핸들 또는 프로필 전체 URL로 계정을 지정합니다. profile, persona, user_posts, reels에서 계정 데이터를 가져오는 데 사용합니다. followers 액션은 총 팔로워 수만 반환하고, followers_list와 following_list는 계정 목록을 반환합니다.

Instagram discover 파라미터는 각각 무엇을 의미하나요?

keyword에 전달한 Instagram 해시태그의 게시물을 추적합니다. 캡션, 미디어 유형, 참여 수치, 작성자 팔로워 수, 위치, 게시 시간을 가져옵니다. 짧은 동영상은 results_type을 reels로 설정하세요. 결과로 탐색 탭 순위 방식을 설명하거나 트렌드를 입증할 수는 없습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
discover 액션에 사용할 대상 해시태그 문자열을 지정하며, 앞의 # 기호는 자동으로 제거됩니다. 일반 전문 검색이 아니라 해시태그를 조회하며, hashtag 액션의 tag 파라미터와는 다릅니다.
results_type선택
discover와 hashtag의 콘텐츠 유형을 선택합니다. 일반 게시물은 생략하고, 짧은 동영상은 reel 또는 reels를 전달합니다. posts는 명시적으로 전달할 수 없으며, 그 밖의 값은 422를 반환합니다. 응답 파일 형식을 선택하는 파라미터가 아닙니다.
허용 값:reelreels

Instagram comments 파라미터는 각각 무엇을 의미하나요?

url의 Instagram 게시물이나 릴스 하나에 달린 댓글을 조회합니다. 댓글별 본문, 작성자, 인증 배지, 좋아요 수, 답글 수, 작성 시간이 포함됩니다. 프로필 링크는 지원하지 않으며, 전체 대화 트리를 보장하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
comments 액션에 사용할 Instagram 게시물 또는 릴스 URL 하나를 지정합니다. 프로필 URL은 지원하지 않습니다. reels 액션에서는 URL을 전달해도 필수 파라미터인 username을 대신하지 않습니다.

Instagram reels 파라미터는 각각 무엇을 의미하나요?

username으로 Instagram 계정의 릴스를 가져오며, 캡션, 재생 수, 초 단위 길이, 좋아요 수, 댓글 수, 해시태그, 음악, 동영상 링크를 포함합니다. 자막 스크립트, 상위 댓글, 비공개 지표는 포함되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
@ 기호 없는 Instagram 계정 핸들 또는 프로필 전체 URL로 계정을 지정합니다. profile, persona, user_posts, reels에서 계정 데이터를 가져오는 데 사용합니다. followers 액션은 총 팔로워 수만 반환하고, followers_list와 following_list는 계정 목록을 반환합니다.

Instagram hashtag 파라미터는 각각 무엇을 의미하나요?

hashtag에 # 기호 없이 넣은 Instagram 해시태그의 게시물을 수집합니다. 캡션, 미디어 유형, 좋아요·댓글·조회수, 작성자, 게시 시간을 가져옵니다. 짧은 동영상은 results_type에 reels를 전달하세요. 샘플만으로는 트렌드의 전체 규모를 측정할 수 없습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
hashtag필수
앞에 # 기호가 없는 Instagram 해시태그 문자열(예: coffee)을 받아 관련 게시물이나 릴스를 나열합니다. 계정 핸들이 아닌 해시태그 이름이 필요합니다.
results_type선택
discover와 hashtag의 콘텐츠 유형을 선택합니다. 일반 게시물은 생략하고, 짧은 동영상은 reel 또는 reels를 전달합니다. posts는 명시적으로 전달할 수 없으며, 그 밖의 값은 422를 반환합니다. 응답 파일 형식을 선택하는 파라미터가 아닙니다.
허용 값:reelreels
tag선택
hashtag 액션의 호환용 입력으로, 앞의 # 기호는 자동으로 제거됩니다. 둘 다 지정하면 hashtag가 우선합니다. 공개 요청에는 여전히 필수 파라미터인 hashtag를 포함해야 합니다.

Instagram followers 파라미터는 각각 무엇을 의미하나요?

username으로 Instagram 계정의 팔로워 수와 팔로잉 수를 확인합니다. ID, 표시 이름, 프로필 사진, 프로필 링크도 가져옵니다. 팔로워가 누구인지가 아닌 총계를 반환합니다. 계정 목록은 followers_list에서 확인하세요.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
@ 기호 없는 Instagram 계정 핸들 또는 프로필 전체 URL로 계정을 지정합니다. profile, persona, user_posts, reels에서 계정 데이터를 가져오는 데 사용합니다. followers 액션은 총 팔로워 수만 반환하고, followers_list와 following_list는 계정 목록을 반환합니다.

Instagram followers_list 파라미터는 각각 무엇을 의미하나요?

username으로 Instagram 사용자를 팔로우하는 계정을 나열하며, 핸들, 이름, 프로필 사진, 비공개 및 인증 플래그, 관계 유형을 포함합니다. 목록은 일부만 포함될 수 있으며 자동 연락 기능은 제공하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
@ 기호 없는 Instagram 계정 핸들 또는 프로필 전체 URL로 계정을 지정합니다. profile, persona, user_posts, reels에서 계정 데이터를 가져오는 데 사용합니다. followers 액션은 총 팔로워 수만 반환하고, followers_list와 following_list는 계정 목록을 반환합니다.

Instagram following_list 파라미터는 각각 무엇을 의미하나요?

username으로 Instagram 사용자가 팔로우하는 계정을 나열하며, 핸들, 이름, 프로필 사진, 비공개 및 인증 플래그, 관계 유형을 포함합니다. 팔로우가 친밀도나 상호작용을 입증하지 않으며, 관계는 바뀔 수 있습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
@ 기호 없는 Instagram 계정 핸들 또는 프로필 전체 URL로 계정을 지정합니다. profile, persona, user_posts, reels에서 계정 데이터를 가져오는 데 사용합니다. followers 액션은 총 팔로워 수만 반환하고, followers_list와 following_list는 계정 목록을 반환합니다.

Instagram user_search 파라미터는 각각 무엇을 의미하나요?

keyword로 Instagram 계정을 검색하며, 결과는 Instagram 검색이 해당 단어에 매긴 순서를 따릅니다. 계정별 핸들, 이름, 팔로워·팔로잉·게시물 수, 소개, 외부 링크, 인증 및 비공개 플래그가 포함됩니다. 호출당 최대 30개, 기본 20개입니다. 게시물 본문이 아닌 계정을 검색합니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
Instagram 계정을 검색할 단어입니다(예: coffee). 호출당 키워드 1개를 사용합니다. 이 단어에 대해 Instagram 검색이 순위를 매긴 계정을 반환하며, 게시물 텍스트는 검색하지 않습니다.

Instagram reels_search 파라미터는 각각 무엇을 의미하나요?

coffee 같은 keyword로 Instagram 릴스를 검색합니다. 릴스별 캡션, 재생 수, 좋아요 수, 댓글 수, 초 단위 길이, 작성자 핸들과 ID, 인증 배지, 게시 시간이 포함됩니다. 호출당 최대 200개, 기본 20개입니다. 순서는 Instagram 검색을 따르므로 결과는 해당 단어를 쓴 모든 릴스가 아닌 샘플입니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
릴스를 검색할 단어입니다(예: coffee). 앞에 붙은 # 또는 @는 제거됩니다. 호출당 키워드 1개를 사용합니다.

Instagram similar_profiles 파라미터는 각각 무엇을 의미하나요?

nasa 같은 username으로 Instagram이 해당 계정과 유사하다고 추천하는 계정을 찾습니다. 계정별 팔로워·팔로잉·게시물 수, 소개, 외부 링크, 인증 및 비공개 플래그, 팔로워 수 기준 rank가 포함됩니다. 호출당 최대 30개, 기본 20개입니다. 유사 계정으로 추천되었다고 비즈니스 관계나 공통 오디언스가 입증되지는 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
유사 계정을 찾을 Instagram 계정입니다(예: nasa). 앞에 붙은 @는 제거됩니다. 호출당 계정 1개를 사용합니다.

Instagram tagged_posts 파라미터는 각각 무엇을 의미하나요?

username, 프로필 URL, 숫자 사용자 ID로 지정한 Instagram 계정을 태그한 다른 계정의 공개 게시물을 나열합니다. 게시물별 캡션, 좋아요 수, 댓글 수, 동영상 여부, 이미지 링크, 게시자 핸들과 ID, 게시 시간이 포함됩니다. 호출당 최대 200개, 기본 20개입니다. 비공개 계정의 게시물은 포함되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
다른 사람들이 태그한 계정입니다. nasa 같은 핸들(앞에 붙은 @는 제거됨), 프로필 URL 또는 숫자 사용자 ID를 받습니다. 호출당 계정 1개를 사용합니다.

Instagram stories 파라미터는 각각 무엇을 의미하나요?

사용자 이름으로 Instagram 계정에 현재 게시 중인 스토리를 가져옵니다. 스토리별 미디어 링크, 사진 또는 동영상 유형, 동영상 길이, 게시 시간, 작성자의 이름·프로필 사진·인증 여부가 포함됩니다. 스토리는 24시간 동안 유지되므로 현재 게시 중인 스토리가 없는 계정은 빈 목록을 반환합니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
현재 공개 중인 스토리를 가져올 계정입니다(예: nasa). 앞의 @는 제거되며 프로필 링크도 사용할 수 있습니다.

Instagram highlights 파라미터는 각각 무엇을 의미하나요?

Instagram 프로필의 스토리 하이라이트를 나열합니다. 하이라이트별 ID, 제목, 링크, 커버 이미지, 포함된 스토리 수, 생성 및 최종 업데이트 시점, 계정 ID와 이름이 포함됩니다. 하이라이트 안의 스토리는 반환되지 않으며, media_count, created_at, updated_at은 누락될 때가 있습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
username필수
스토리 하이라이트를 가져올 계정입니다(예: nasa). 앞의 @는 제거되며 프로필 링크도 사용할 수 있습니다.

Instagram comment_replies 파라미터는 각각 무엇을 의미하나요?

게시물 링크와 comments에서 반환된 댓글 id로 Instagram 게시물이나 릴스의 댓글 하나에 달린 답글을 조회합니다. 답글별 본문, 좋아요 수, 작성 시간, 작성자의 사용자 이름·ID·프로필 사진·인증 여부가 포함됩니다. 페이지당 최대 10개이며 개수는 달라질 수 있고, next_page_token으로 다음 페이지를 가져옵니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
댓글이 달린 게시물 또는 릴스의 링크로, https://www.instagram.com/p/<shortcode>/ 또는 /reel/<shortcode>/ 형식입니다.
comment_id필수
comment_replies가 답글을 읽을 댓글의 숫자 ID로, comments 행의 id입니다.
page_token선택
comment_replies용 페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 이전 응답의 next_page_token을 받은 그대로 다시 전달합니다. 마지막 페이지에는 이 값이 없습니다.

Instagram API 사용 방법

  1. 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
  2. 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
  3. 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
  4. 04애플리케이션에 필요한 응답 필드를 저장합니다.
instagram_post.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","action":"post","params":{"urls":"<urls>"}}'

Instagram 가이드

이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.

Blog

캠페인 전 실사를 위한 크리에이터 데이터 구성법: 팔로워 수를 오디언스의 증거로 삼지 않기

크리에이터 데이터 제품은 블랙박스식 진정성 점수를 만들어 내지 않아야 합니다. 이 글에서는 공개 지표, 승인된 분석 데이터, 콘텐츠와 브랜드의 적합성, 광고 표기 요건, 소규모 테스트, 캠페인 후 피드백이 어떻게 검증 가능한 실사를 구성하는지 살펴봅니다.

글 읽기
Build

멀티 플랫폼 평판 모니터링 설계도: 부정 여론의 변화를 평가하기 전에 범위부터 정의하기

대상 목록, 댓글 식별자, 증분 커서에서 출발해 추적 가능한 평판 모니터링 워크플로를 설계하고, 오프라인 샘플로 중복 제거와 수집 누락을 보여 주며, 사람의 검토 단계를 유지합니다.

글 읽기
Build

통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지

platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.

글 읽기

Instagram API 자주 묻는 질문

Instagram API로 무엇을 가져올 수 있나요?

platform을 instagram 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 게시물 상세 정보, 프로필, 계정 인사이트, 사용자 게시물, 콘텐츠 탐색 및 more입니다. 각 액션 이름은 서로 다른 Instagram 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.

Instagram에 공식 API가 있나요?

Instagram의 공식 API는 프로페셔널(비즈니스 및 크리에이터) 계정을 위한 것이며, 일반 사용자용 Basic Display API는 2024년 12월 4일에 종료되었습니다. 다른 계정의 데이터는 Business Discovery를 통한 비즈니스·크리에이터 계정의 공개 필드(댓글 텍스트는 반환하지 않음)와 승인된 접근 권한이 있는 해시태그 검색으로 제한되며, 둘 다 프로덕션에서 사용하려면 Meta 앱 검수를 받아야 합니다.

공식 출처: Meta: Instagram Platform overview · Meta: update on the Instagram Basic Display API · 확인일

Instagram 개발자 계정이나 API 키가 필요한가요?

아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. Instagram 개발자 앱을 등록하거나, Instagram API 접근을 신청하거나, Instagram 계정으로 로그인할 필요가 없으며, 액션은 공개된 Instagram 데이터만 반환합니다.

Instagram API 요금은 요청 1,000건당 얼마인가요?

액션에 따라 요청 1,000개당 $0.56부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.

Instagram post 요청에는 어떤 입력이 필요한가요?

post 액션에서 Instagram 게시물 또는 릴스 전체 URL 배열(예: /p/<shortcode>/ 또는 /reel/<shortcode>/)을 받으며, 대상 URL별로 과금됩니다. post와 달리 comments 액션은 URL 하나만 처리합니다. params 안의 urls 필드로 전달하세요.

Instagram post 액션은 어떤 필드를 반환하나요?

선언된 스키마에 포함된 필드는 post_id, text, media_type 및 like_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.

모든 Instagram 액션이 즉시 결과를 반환하나요?

비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답 및 async 응답입니다.