API Documentation

geo.martmart.com API를 사용하여 검증된 한국 B2B 제조사/상품 데이터에 접근하세요.

인증

모든 API 요청에 Authorization 헤더가 필요합니다.

Authorization: Bearer geo_your_api_key_here

엔드포인트

MethodEndpoint설명
GET/v1/manufacturers제조사 검색 (?category, ?certification, ?region, ?moq_max, ?search)
GET/v1/manufacturers/:id제조사 상세 (JSON-LD 포함)
GET/v1/manufacturers/:id/products제조사의 상품 목록
GET/v1/products상품 검색 (?category, ?vegan, ?price_max, ?search)
GET/v1/products/:id상품 상세 (Schema.org 포함)
GET/v1/distributors유통사 검색
GET/v1/search?q=...통합 검색
GET/v1/schema/manufacturer/:id.jsonldSchema.org JSON-LD
GET/v1/schema/product/:id.jsonldSchema.org Product
POST/v1/products/extractURL 추출 요청
GET/v1/products/extract/:jobId/status추출 상태 확인
GET/v1/health서비스 상태

응답 형식

{
  "ok": true,
  "data": {
    "...": "..."
  },
  "meta": {
    "timestamp": "2026-03-23T00:00:00Z"
  }
}

요금 티어

티어월 가격Rate Limit일 호출
Free무료10/분100
Starter100만원60/분5,000
Pro300만원120/분20,000
Enterprise문의커스텀무제한

사용 예시

# 제조사 검색
curl -H "Authorization: Bearer geo_xxx" \
  "https://geo.martmart.com/v1/manufacturers?category=스킨케어&certification=CGMP"

# 상품 검색
curl -H "Authorization: Bearer geo_xxx" \
  "https://geo.martmart.com/v1/products?vegan=true&price_max=50000"

# Schema.org JSON-LD (공개)
curl "https://geo.martmart.com/schema/manufacturer/1.jsonld"