본문으로 건너뛰기

Capzy Data API. 소스를 선택하세요.

지원되는 사이트의 엔드포인트를 찾아 매개변수를 보내고 JSON을 받으세요. 여기서 레퍼런스를 살펴본 다음 대시보드 플레이그라운드에서 요청을 실행하고 확인하세요.

Amazon 검색 한눈에 보기

소스 + 액션GET /v1/amazon/search
쿼리wireless earbuds
응답 필드organic_results · 제목, 가격, ASIN

설명용 예시

필요한 소스 찾기

소스마다 고유한 엔드포인트, 필수 입력값, 응답 형식이 있습니다. 연동을 구축하기 전에 레퍼런스를 열어 지원 범위를 확인하세요.

모든 소스 (83)

첫 Data API 요청

이 Amazon 예제는 소스별 GET 엔드포인트를 사용합니다. HTTP 200은 소스 데이터를 반환하고, HTTP 202는 대기 상태와 jobId를 반환합니다. 다른 요청을 보내기 전에 Data API 대시보드의 실행 페이지에서 대기 중인 작업을 확인하세요.

  1. Data API 키 만들기

    Data API 대시보드를 열어 전용 Data API 키를 복사하세요. 요금제 크레딧이 먼저 사용되며, 추가 사용량은 공유 Capzy 계정 잔액에서 청구됩니다.

    Data API 열기
  2. 소스와 액션 선택

    사이트 레퍼런스에서 메서드, 경로, 필수 매개변수를 확인하세요. Amazon 검색 예제는 query와 domain을 /v1/amazon/search로 보냅니다.

    Amazon 검색 매개변수 읽기
  3. 플레이그라운드에서 JSON 확인

    대시보드에서 해당 소스를 열고 액션을 선택한 다음 입력값을 채워 요청을 실행하세요. 실행하기 전에 현재 엔드포인트 가격을 확인하세요.

    Amazon 검색 플레이그라운드 열기
amazon_search.py
# Install: pip install requests
import os
import requests

response = requests.get(
    "https://api.capzy.ai/v1/amazon/search",
    headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
    params={"query": "wireless earbuds", "domain": "com"},
    timeout=120,
)
response.raise_for_status()
data = response.json()
if response.status_code == 202:
    print("Pending:", data.get("status"), "Job:", data.get("jobId"))
    print("Inspect this job in https://capzy.ai/dashboard/data-api/runs")
else:
    for item in data.get("organic_results", []):
        print(item["title"], item.get("price"))
    print("Credits used:", response.headers.get("X-Credits-Used"))

호출하기 전에 계약을 파악하세요

인증은 모든 Data API 소스에서 공통입니다. 메서드, 매개변수, 반환 필드는 엔드포인트마다 다릅니다.

X-API-Key필수 · 헤더
이 헤더에 전용 Data API 키를 담아 보내세요. 서버에 보관하고, 이 예제에서는 CAPZY_DATA_API_KEY에서 읽어 옵니다.
/v1/{source}/{path}엔드포인트별 · 경로
소스 레퍼런스의 메서드와 경로를 따르세요. 예를 들어 GET /v1/amazon/search는 query와 domain을 쿼리 매개변수로 받습니다.
X-Credits-Used응답 헤더
요청에 청구된 크레딧을 확인하세요. 엔드포인트 가격과 요금제 할인은 대시보드와 소스 레퍼런스에 표시됩니다.
X-Next-Cursor응답 헤더 · 있는 경우
일부 엔드포인트는 다음 페이지용 커서를 반환합니다. 각 엔드포인트의 페이지네이션 매개변수를 사용하세요. 모든 소스가 같은 페이지네이션 모델을 사용하지는 않습니다.

소스의 실제 응답 필드를 사용하세요

HTTP 200 Amazon 검색 응답은 최상위에 organic_results를 제공합니다. HTTP 202는 대신 jobId가 담긴 상태 봉투를 반환하며, 대시보드 실행 페이지에서 확인할 수 있습니다. 이 축약된 성공 응답은 설명용 상품 데이터를 사용합니다.

response.example.json
{
  "search_information": {
    "query": "wireless earbuds"
  },
  "organic_results": [
    {
      "title": "Example wireless earbuds",
      "price": "$27.99",
      "extracted_price": 27.99,
      "asin": "EXAMPLE001"
    }
  ]
}

organic_results · 제목, 가격, ASIN

매개변수

요금

Data API 요금제에는 월간 크레딧 허용량이 포함됩니다. 추가 사용량은 공유 Capzy 계정 잔액에서 청구됩니다. 현재 엔드포인트 크레딧 가격은 소스 레퍼런스를 확인하세요.

현재 가격 로드 중…

알아 두면 좋은 내용

플레이그라운드는 어디에서 열리나요?

대시보드 → Data API → 스크래퍼에서 열립니다. 소스 링크는 해당 소스의 빌더를 엽니다. 엔드포인트 링크는 해당 액션을 미리 선택하므로 실행하기 전에 필수 입력값을 확인할 수 있습니다.

솔버 API 키를 사용할 수 있나요?

Data API 대시보드에 표시된 전용 Data API 키를 사용하세요. Data API에는 자체 요금제 제어와 포함 크레딧이 있으며, 추가 사용량은 공유 Capzy 계정 잔액으로 충당됩니다.

모든 소스가 같은 JSON을 반환하나요?

아니요. 각 엔드포인트에는 소스별 응답 형식이 있습니다. 문서화된 응답을 확인하고 애플리케이션에서 누락되거나 선택적인 필드를 처리하세요.

엔드포인트가 곧 출시 예정이라면 어떻게 하나요?

대시보드는 검증되지 않았거나 실행할 수 없는 엔드포인트를 표시합니다. 그곳에 표시된 지원 액션을 사용하세요. 레퍼런스 항목이 있다고 해서 엔드포인트가 준비되었다는 뜻은 아닙니다.

소스를 찾으세요. 실제 요청을 시도하세요.

대시보드 플레이그라운드에서 입력값, 응답, 현재 요금을 한곳에서 볼 수 있습니다.

플레이그라운드 열기