Instagram Hashtag Posts
Instagram 해시태그 게시물은 검색한 해시태그와 연결된 공개 사진 또는 릴스로, 캡션, 크리에이터 정보, 미디어, 타임스탬프, 공개된 참여 지표를 담고 있습니다. 이러한 콘텐츠 및 출처 신호는 주제 탐색, 해시태그 간 비교, 크리에이터 조사, 기간을 정한 모니터링에 활용할 수 있습니다.
Instagram Hashtag Posts API 주요 기능
- 여러 해시태그 수집#가 있든 없든 해시태그를 하나 이상 제출할 수 있으며, results_limit은 제출한 해시태그마다 따로 적용됩니다.
- 기간 및 미디어 필터탐색 범위를 최근 1시간, 하루, 일주일, 한 달, 1년으로 제한하고, 전체 게시물 또는 릴스만 선택할 수 있습니다.
- 정규화된 게시물 레코드게시물 ID, 숏코드, 정식 URL, 캡션, 작성자 정보, 미디어 참조 정보, 해시태그, 멘션, 타임스탬프를 하나의 구조로 받습니다.
- 출처 맥락과 참여 지표각 레코드를 만든 제출 해시태그를 확인 가능한 좋아요, 댓글, 조회, 재생 수와 함께 유지합니다.
Instagram Hashtag Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
hashtags | 필수 | 비어 있지 않은 해시태그를 쉼표나 줄바꿈으로 구분해 하나 이상 지정합니다. #는 있어도 없어도 됩니다. |
results_limit | 선택 | 해시태그마다 요청하는 최대 레코드 수입니다. 기본값은 100이며 10 이상 2,000 이하의 정수를 받습니다. |
published_within | 선택 | 게시 기간으로, 선택 값이며 hour, day, week, month, year 중 하나입니다. |
media_type | 선택 | 콘텐츠 필터입니다. all은 지원되는 모든 게시물 유형을 포함하고, reels는 결과를 릴스로 제한합니다. |
Instagram Hashtag Posts API 사용 방법
해시태그를 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 게시물 레코드를 커서 페이지네이션으로 읽습니다.
- 앞의 #가 있든 없든 중복되지 않는 해시태그를 하나 이상 준비합니다.
- hashtags와 선택 필드인 results_limit, published_within, media_type을 /v1/instagram/hashtag-posts로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, results.has_more가 true인 동안 results.next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/instagram/hashtag-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueInstagram Hashtag Posts API 추천 활용 사례
- 주제별 콘텐츠 탐색: 캠페인, 이벤트, 커뮤니티, 업계 해시태그와 연결된 공개 게시물로 검토 가능한 데이터셋을 만듭니다.
- 해시태그 간 비교: 모든 레코드를 만든 제출 해시태그를 보존한 채로 공개된 참여 지표와 콘텐츠 패턴을 비교합니다.
- 최근 릴스 모니터링: 게시 기간과 릴스 전용 필터를 함께 사용해 선택한 해시태그 주변의 시의성 있는 숏폼 콘텐츠를 검토합니다.
- 크리에이터·콘텐츠 정보 보강: 게시물 식별 정보, 작성자 정보, 캡션, 미디어, 공개된 지표를 조사, 캠페인 또는 모더레이션 레코드와 결합합니다.
Instagram Hashtag Posts API 활용 팁
- 수집기는 제출한 값을 각각 독립적으로 처리하므로, 입력 해시태그의 중복을 제거하고 주제마다 하나의 철자만 사용하세요.
- results_limit은 요청 전체가 아니라 해시태그마다 적용되므로, 해시태그별로 수집량을 계획하세요.
- 정기 모니터링에서 일관된 기간과 콘텐츠 유형이 필요하면 published_within과 media_type을 함께 사용하세요.
- 겹치는 결과는 안정적인 게시물 ID, 숏코드 또는 정식 URL로 중복을 제거하고, 출처 표기를 위해 extra.hashtag는 유지하세요.
- 게시물마다 출처에서 제공되는 정보가 다를 수 있으므로 미디어, 카운터, 타임스탬프 등 공개 필드는 선택 값으로 처리하세요.
관련 API
Instagram Hashtag Posts API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Search API — 키워드 또는 핸들로 공개 프로필을 검색하며, 계정 정보와 공개된 계정 신호를 포함합니다.
- Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
- Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
- Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.
- Instagram Reels Search API — 텍스트 검색어로 공개 릴스를 검색하며, 캡션, 크리에이터, 미디어, 타임스탬프, 공개된 참여도, 검색어 맥락을 포함합니다.
- Instagram Hashtag Search API — 키워드와 일치하는 해시태그를 찾으며, 해시태그 이름, ID, 태그 페이지 URL, 공개 게시물 수를 포함합니다.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Account Age Checker API