Skip to content

Guides

Five end-to-end use cases that compose Sell-Po public endpoints into a complete sourcing workflow.

Each guide is intentionally short — it shows the call chain, the inputs you must supply, and the response shape you can rely on. Combine them with the per-endpoint detail in API Reference.

Scenario: Discover top-ranked Naver Shopping listings for a target keyword.

curl -sS -X GET \
  -H "X-Naver-Client-Id: $NAVER_CLIENT_ID" \
  -H "X-Naver-Client-Secret: $NAVER_CLIENT_SECRET" \
  "https://api.sell-po.co.kr/api/naver/search?query=humidifier&display=20&sort=sim"

Response highlights:

  • items[].title — listing title with HTML <b> tags around matched tokens
  • items[].lprice / hprice — Korean Won price range
  • items[].mallName — seller display name
  • items[].productId — opaque identifier, stable across calls

Use this endpoint for keyword research and competitor mapping. Pair it with /api/naver/datalab/trend to overlay search demand.

Scenario: Cross-validate a candidate keyword on Coupang to confirm marketplace breadth.

curl -sS -X GET \
  -H "X-Internal-Master: $SELLPO_API_KEY" \
  "https://api.sell-po.co.kr/api/coupang/search?query=humidifier&page=1"

Response highlights:

  • items[].productName — listing title
  • items[].salePrice — current sale price
  • items[].rating / reviewCount — social proof signals

Combine Coupang counts and ratings with Naver impressions to build a multi-marketplace demand index.

Scenario: Locate Chinese suppliers for a validated product idea.

curl -sS -X POST \
  -H "Content-Type: application/json" \
  -H "X-Internal-Master: $SELLPO_API_KEY" \
  -d '{"keyword": "Humidifier 300ML", "page": 1}' \
  "https://api.sell-po.co.kr/api/alibaba/search"

Response highlights:

  • items[].title — Chinese product title
  • items[].price.min / max — quoted RMB range
  • items[].moq — minimum order quantity
  • items[].supplier.name — supplier display name

Combine MOQ and quoted price with Korean retail price to seed margin analysis.

4. Margin analysis

Scenario: Compute landed cost, fees, and net margin for a sourcing candidate.

curl -sS -X POST \
  -H "Content-Type: application/json" \
  -H "X-Internal-Master: $SELLPO_API_KEY" \
  -d '{
    "supply_price_rmb": 35.0,
    "exchange_rate": 188.0,
    "shipping_cost_krw": 2500,
    "sale_price_krw": 19900,
    "platform": "naver"
  }' \
  "https://api.sell-po.co.kr/api/analysis/margin"

Response highlights:

  • landed_cost_krw — RMB cost converted plus shipping
  • platform_fee_krw — platform commission estimate
  • payment_fee_krw — PG fee estimate
  • net_margin_krw / net_margin_rate — profit and percentage

Margin analysis is deterministic and synchronous — safe to call inline from a UI form.

5. AI integrated analysis (verdict)

Scenario: Produce a GO / CAUTION / NO-GO verdict by composing search, margin, and AI agents.

curl -sS -X POST \
  -H "Content-Type: application/json" \
  -H "X-Internal-Master: $SELLPO_API_KEY" \
  -d '{
    "keyword": "humidifier",
    "supply_price_rmb": 35.0,
    "sale_price_krw": 19900,
    "exchange_rate": 188.0
  }' \
  "https://api.sell-po.co.kr/api/agents/integrated"

Response highlights:

  • verdict — GO / CAUTION / NO_GO
  • score — composite confidence in the 0..100 range
  • agents[] — per-agent breakdown (blue ocean, competition, sales estimate, SEO, seasonality)
  • evidence[] — citations the agents used

The integrated endpoint orchestrates multiple Sell-Po internal agents in parallel; expect a typical p95 latency of ~6s for the first call and faster for cached follow-ups.