instagram/
search-hashtags

키워드로 Instagram 해시태그를 검색하고, 일치하는 태그의 ID, 태그 페이지 링크, 각 태그를 사용한 게시물 수를 반환합니다.

Instagram Hashtag Search API

키워드 입력
관련 해시태그
게시물 수
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Hashtag Search

해시태그는 Instagram 게시물을 주제별로 묶어 주며, 태그마다 사용한 게시물 수가 공개되어 있어 게시물이 수백 개인 틈새 태그부터 수억 개에 이르는 대형 태그까지 규모가 다양합니다. 같은 키워드를 공유하는 태그와 각 태그의 규모를 살펴보면 캠페인에 쓸 해시태그를 고르고, 특정 주제에 대해 얼마나 많은 게시물이 올라오는지 가늠하는 데 도움이 됩니다.

Instagram Hashtag Search API 주요 기능

  • 키워드 하나로 태그 검색travel처럼 키워드를 #가 있든 없든 보내면 일치하는 해시태그를 반환합니다.
  • 태그별 규모 확인해시태그마다 metrics.posts_count, ID, 태그 페이지 링크가 함께 제공됩니다.
  • 필요한 만큼 조회results_limit로 해시태그를 1~100개까지 받을 수 있으며 기본값은 50개입니다.

Instagram Hashtag Search API 매개변수

매개변수필수설명
query필수해시태그 이름과 대조할 키워드 하나로, 최대 100자입니다. 앞의 #는 생략할 수 있습니다.
results_limit선택반환할 해시태그 수로, 1~100 사이의 값입니다. 기본값은 50입니다.

Instagram Hashtag Search API 사용 방법

키워드를 보내고, 일치하는 해시태그를 게시물 수와 함께 받아 읽습니다.

  1. 주제에 맞는 키워드를 정합니다. 예: travel.
  2. {"query": "travel", "results_limit": 50}을 /v1/instagram/search-hashtags로 POST합니다.
  3. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. results.items에서 해시태그를 읽고, 규모가 큰 순서로 보려면 metrics.posts_count 기준으로 정렬합니다.
curl -X POST "https://api.socq.ai/v1/instagram/search-hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"travel","results_limit":50}'

# Each result is a hashtag with metrics.posts_count.
# Read them from GET /v1/tasks/{task_id}.

Instagram Hashtag Search API 추천 활용 사례

  • 캠페인 해시태그 선정: 관련 태그의 게시물 수를 비교해, 규모가 큰 인기 해시태그와 캠페인에 더 잘 맞는 작은 해시태그를 함께 구성합니다.
  • 주제 규모 가늠하기: 키워드에 해당하는 해시태그의 게시물 수를 합산해 Instagram에서 그 주제로 얼마나 많은 게시물이 올라오는지 가늠합니다.
  • 추적 목록 만들기: 하나의 주제를 둘러싼 해시태그를 모아 Instagram Hashtag Posts에 넣고 지속적으로 모니터링합니다.

Instagram Hashtag Search API 활용 팁

  • 결과는 Instagram의 일치 순서로 도착하므로, metrics.posts_count 기준 정렬은 직접 하세요.
  • 키워드의 단수형, 복수형, 현지 언어 표기를 함께 시도하면 더 많은 관련 태그를 찾을 수 있습니다.
  • 고른 태그를 Instagram Hashtag Posts로 보내 해당 태그의 게시물을 확인하세요.

Instagram Hashtag Search API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Instagram Followers Count API — 공개 프로필 정보와 공개된 팔로워·팔로잉·게시물 수를 가져옵니다.
  • Instagram Search API — 키워드 또는 핸들로 공개 프로필을 검색하며, 계정 정보와 공개된 계정 신호를 포함합니다.
  • Instagram Hashtag Posts API — 해시태그로 공개 게시물을 찾으며, 출처 태그 맥락, 미디어, 크리에이터, 타임스탬프, 공개된 참여도를 포함합니다.
  • Instagram Reels Search API — 텍스트 검색어로 공개 릴스를 검색하며, 캡션, 크리에이터, 미디어, 타임스탬프, 공개된 참여도, 검색어 맥락을 포함합니다.
  • Instagram Location Info API — ID 또는 위치 페이지 URL로 위치 하나를 조회하며, 이름, 카테고리, 전화번호, 좌표, 태그된 게시물 수를 포함합니다.
  • Instagram Location Search API — 장소 이름 또는 위도·경도로 위치 ID를 찾으며, 이름, 주소, 도시, 좌표를 포함합니다.

다른 플랫폼 둘러보기

Instagram 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Hashtag Search API — 자주 묻는 질문

Instagram Hashtag Search API는 키워드와 일치하는 Instagram 해시태그를 찾는 프로그래밍 인터페이스입니다. 해시태그 이름, ID, 태그 페이지 링크, 각 해시태그를 사용한 게시물 수를 반환합니다.

이 엔드포인트에 키워드를 보내면 일치하는 해시태그를 반환하며, 각 해시태그에는 게시물 수와 태그 페이지 링크가 포함됩니다.

각 결과의 metrics.posts_count에 Instagram이 해당 해시태그에 대해 표시하는 게시물 수가 들어 있습니다.

해시태그 이름을 Instagram Hashtag Posts API에 전달하면 해당 태그를 사용한 게시물을 반환합니다.

반환되는 해시태그 1개당 0.5 크레딧이 차감되며, results_limit로 총 개수의 상한을 정할 수 있습니다.