instagram/
hashtag-posts

하나 이상의 해시태그에 대한 공개 Instagram 게시물을 수집하여, 작성자 정보, 캡션, 미디어, 출처 해시태그, 타임스탬프, 공개된 참여 지표를 반환합니다.

Instagram Hashtag Posts API

해시태그 탐색
게시물 레코드
기간 및 미디어 필터
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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를 폴링한 뒤, 정규화된 게시물 레코드를 커서 페이지네이션으로 읽습니다.

  1. 앞의 #가 있든 없든 중복되지 않는 해시태그를 하나 이상 준비합니다.
  2. hashtags와 선택 필드인 results_limit, published_within, media_type을 /v1/instagram/hashtag-posts로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /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 true

Instagram Hashtag Posts API 추천 활용 사례

  • 주제별 콘텐츠 탐색: 캠페인, 이벤트, 커뮤니티, 업계 해시태그와 연결된 공개 게시물로 검토 가능한 데이터셋을 만듭니다.
  • 해시태그 간 비교: 모든 레코드를 만든 제출 해시태그를 보존한 채로 공개된 참여 지표와 콘텐츠 패턴을 비교합니다.
  • 최근 릴스 모니터링: 게시 기간과 릴스 전용 필터를 함께 사용해 선택한 해시태그 주변의 시의성 있는 숏폼 콘텐츠를 검토합니다.
  • 크리에이터·콘텐츠 정보 보강: 게시물 식별 정보, 작성자 정보, 캡션, 미디어, 공개된 지표를 조사, 캠페인 또는 모더레이션 레코드와 결합합니다.

Instagram Hashtag Posts API 활용 팁

  • 수집기는 제출한 값을 각각 독립적으로 처리하므로, 입력 해시태그의 중복을 제거하고 주제마다 하나의 철자만 사용하세요.
  • results_limit은 요청 전체가 아니라 해시태그마다 적용되므로, 해시태그별로 수집량을 계획하세요.
  • 정기 모니터링에서 일관된 기간과 콘텐츠 유형이 필요하면 published_within과 media_type을 함께 사용하세요.
  • 겹치는 결과는 안정적인 게시물 ID, 숏코드 또는 정식 URL로 중복을 제거하고, 출처 표기를 위해 extra.hashtag는 유지하세요.
  • 게시물마다 출처에서 제공되는 정보가 다를 수 있으므로 미디어, 카운터, 타임스탬프 등 공개 필드는 선택 값으로 처리하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Hashtag Posts API — 자주 묻는 질문

Instagram Hashtag Posts API는 제출한 하나 이상의 해시태그와 연결된 공개 Instagram 게시물을 가져오는 프로그래밍 인터페이스입니다. 정규화된 게시물 식별 정보, 캡션, 작성자, 미디어, 타임스탬프, 출처 해시태그 정보, 공개된 참여 지표를 반환합니다.

비어 있지 않은 hashtags 배열을 보내세요. 값에는 앞의 #를 붙여도 생략해도 됩니다. results_limit은 10 이상 2,000 이하를 받고 기본값은 100이며, 해시태그마다 따로 적용됩니다.

published_within은 hour, day, week, month, year를 받습니다. media_type은 all 또는 reels를 받으며, 생략하면 all이 사용됩니다.

정규화된 결과에는 ID, 숏코드, URL, 캡션, 작성자, 미디어, 해시태그, 멘션, created_at, collected_at, 공개된 좋아요·댓글·조회·재생 수와 함께 일치한 입력을 나타내는 extra.hashtag가 포함될 수 있습니다.

반환된 정규화 레코드 1건당 0.5 크레딧이 청구되며 기본 요금은 없습니다. 예상 요금은 해시태그별 results_limit에 제출한 해시태그 수를 곱해 계산하고, 최종 사용량은 실제로 반환된 레코드를 따릅니다.