피피샤 hashtag API

REST 호출 한 번으로 피피샤 hashtag 데이터를 조회 — 모든 플랫폼이 공유하는 안정적인 JSON 스키마로 정규화됩니다.

게시된 엔드포인트 1개
GET /v1/pipixia/hashtags/{tag}

계약 요약(영어): Get a normalized Pipixia hashtag (capability pipixia.hashtag)

정규화된 응답 엔터티: pipixia/hashtag
capability: pipixia.hashtag

모든 응답에는 신선도(cache / default / live)와 과금 메타데이터도 포함됩니다.

활용 사례

{{platform}} 해시태그·토픽을 구조화된 메타데이터로 변환해 트렌드 대시보드에 바로 연결.
캠페인·이벤트 관련 태그 사용량과 관련 콘텐츠량을 추적.
일관된 정규화 태그로 콘텐츠를 계정 전반에서 토픽별로 그룹화.

응답 필드

Pipixia hashtag card (normalized non-entity payload)

Non-entity payload (type hashtag) — the entity layer clean-skips it; served by the /v1/pipixia surface.

필드	타입	필수	설명
id	string \| null	필수	—
name	string \| null	필수	—
description	string \| null	선택	—
metrics.views	integer	필수	—
metrics.posts	integer	필수	—
platform	"pipixia"	필수	—
type	"hashtag"	필수	—
fetched_at	string	필수	Normalization time (UTC).

필드 비고는 계약 영문 원문으로 표시됩니다.

응답 메타데이터

필드	타입	필수	설명
mode	cache \| default \| live	필수	Effective mode after merging param > max_age > source policy (D-004).
age_seconds	integer \| null	선택	Age of served data; null when unknown.
source_layer	cache \| db \| upstream	필수	Which layer served the response (PRD §10).
stale	boolean	선택	True when stale data was served under stale_if_error / SWR (D-004).
billing.amount_credits	integer	필수	Micro-USD (1e-6 USD) actually charged for this request.
billing.cache_hit	boolean	필수	—

필드 비고는 계약 영문 원문으로 표시됩니다.

요청·응답 예시

GET/v1/pipixia/hashtags/{tag}

curl -H "Authorization: Bearer $MESHDATA_API_KEY" \
  "https://api.fetchpi.com/v1/pipixia/hashtags/trending"

{
  "data": {
    "id": "9257000000001001",
    "platform": "pipixia",
    "type": "hashtag",
    "name": "数据开放",
    "description": "皮皮虾话题面。",
    "metrics": {
      "views": 88000000,
      "posts": 123000
    },
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

무료 데모

무료 계정을 만들고 API 키를 발급받으면 브라우저 Playground에서 바로 호출할 수 있습니다.

Playground에서 사용해 보기

이 엔드포인트의 파라미터 표, 오류 코드, 응답 의미는 API 문서에 있습니다.

엔드포인트 레퍼런스 열기

자주 묻는 질문

해시태그와 토픽은 정규화되나요?

네 — 응답 스키마는 태그 식별자·카운트·메타데이터에 안정적인 필드 이름을 정의하므로 대시보드에서 플랫폼별 파싱이 필요 없습니다.

이 엔드포인트를 무료로 써볼 수 있나요?

네 — 계정을 등록하고 API 키를 발급받으면 콘솔의 Playground에서 호출할 수 있습니다.

hashtag 능력은 어떻게 과금되나요?

Data API는 요청 단위 크레딧 과금이며 cache/live 신선도에 따라 배율이 다릅니다. 현재 능력별 가격은 가격 페이지를 기준으로 합니다.

가격

요청 단위 크레딧 과금, cache/live 신선도 옵션 — 최신 가격은 가격 페이지 기준입니다.

가격 보기 모든 API 둘러보기