SerpBase
POST 전용

API 문서

구조화된 검색 결과, 요청 매개변수와 응답 상태.

Base URL
https://api.serpbase.dev
인증 헤더
X-API-Key: <API_KEY>
과금
요청별 요금이며 실행된 실패도 청구될 수 있습니다
인증

API Keys에서 비밀 키를 발급받고 X-API-Key로 보내세요. URL이나 공개 코드에 넣지 마세요. 제품별 요청 방식과 매개변수를 따르고 HTTP 200만으로 성공을 판단하지 말고 status와 error를 확인하세요. Playground도 크레딧을 사용할 수 있습니다.

elapsed_ms

공통 응답 구조

credits_charged

요청별 요금이며 실행된 실패도 청구될 수 있습니다

request_id

지원 요청 식별자

최소 요청
bash
curl -X POST 'https://api.serpbase.dev/google/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: your_api_key' \
  -d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'

계정 QPS 자동 상향

적격 충전의 지급 확인 후 누적 USD에 따라 QPS가 최소 $3 → 2, $50 → 5, $100 → 10, $200 → 15, $1,000 → 50, $10,000 → 500으로 상향됩니다. $3 미만은 변경하지 않습니다. 기존 높은 한도는 낮추지 않으며 무제한이 아닙니다.

적격 누적 충전액 (USD)상향 후 최소 QPS
≥ $32 QPS
≥ $505 QPS
≥ $10010 QPS
≥ $20015 QPS
≥ $1,00050 QPS
≥ $10,000500 QPS

지급 확인된 USD credit_pack 및 auto_topup만 포함합니다. 구독(Starter Boost 포함), 선물 및 기프트 코드는 제외됩니다. 크레딧 잔액은 누적 USD 결제액이 아닙니다. 비 USD 결제는 환산 없이 USD로 계산하지 않습니다.

같은 계정의 모든 키, 제품 및 게이트웨이는 하나의 QPS 한도를 공유합니다. 키를 늘려도 한도는 늘지 않습니다.

QPS 상향은 지급 확인 후 적용되며 결제 페이지에서 돌아온 것만으로 적용되지 않습니다. 현재 한도는 계정에 표시된 서버 값이며 키 동기화가 지연될 수 있습니다.

과금 모델 및 차감 규칙

카탈로그 요청 요금과 보고된 차감액 해석.

요청마다 카탈로그 고정 요금이 적용되며 반환 페이지 수로 계산하지 않습니다. Web Crawl과 User Agent는 현재 각각 요청당 1크레딧이며 User Agent는 무료가 아닙니다. 출처와 리소스 식별 정보로 확인된 실제 부재는 과금됩니다. no_results, HTTP 404 또는 hydration/파싱 데이터 누락만으로 부재를 입증할 수 없습니다. 실행된 실패도 과금될 수 있으며 모든 실패의 환불을 보장하지 않습니다. credits_charged는 실제 차감액이며 0은 보고된 차감액 0, null 또는 누락은 알 수 없음을 뜻합니다. charge_status가 UNKNOWN이면 숫자가 있어도 알 수 없는 상태입니다. 계정 기록을 확인하고 request_id와 함께 지원팀에 문의하세요. 환불을 가정하거나 무조건 재시도하지 마세요.

에이전트 통합

Claude, Codex, Cursor, Cline/Roo, opencode 등의 에이전트가 API 키로 직접 호출하려면 오픈 소스 MCP 서버 또는 이식 가능한 스킬을 사용하세요.

MCP
SerpBase MCP

도구 지원 AI 클라이언트용 MCP 통합입니다. 검색 도구 선택 전 엔드포인트 카탈로그를 확인하세요.

Claude, Codex, Cursor, Cline/Roo, Continue 등 MCP 지원 클라이언트에 적합합니다.

GitHub에서 보기
Skill
SerpBase Agent Skill

로컬 지침을 읽거나 MCP 서버 대신 경량 스크립트가 필요한 에이전트를 위한 스킬 폴더와 셸 대안입니다.

Codex 스킬, Claude Code 메모리, opencode, OpenClaw형 에이전트 및 셸 실행 환경에 적합합니다.

GitHub에서 보기
MCP 설정
json
{
  "mcpServers": {
    "serpbase": {
      "command": "python",
      "args": ["-m", "serpbase_mcp"],
      "env": {
        "SERPBASE_API_KEY": "your_api_key"
      }
    }
  }
}
스킬 프롬프트
text
Use $serpbase-skill to search Google through SerpBase and return cited structured results.
계정 잔액

활성 API key가 속한 계정의 현재 크레딧 잔액을 조회합니다. 이 요청은 검색 크레딧을 차감하지 않습니다.

GET
0 credits
/account/credits

X-API-Key 헤더에 키를 전달하세요. URL 쿼리 파라미터의 API key는 허용되지 않습니다.

bash
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: your_api_key"
json
{
  "status": 0,
  "credits": 12345,
  "permanent_credits": 10000,
  "expiring_credits": 2345,
  "expiring_expires_at": 1798761600
}

이 엔드포인트는 계정당 분당 60회로 제한됩니다. expiring_expires_at은 Unix 초이며 활성 기간제 크레딧이 없으면 0입니다.

공통 응답 구조

성공 응답은 동일한 최상위 메타데이터를 반환합니다. 엔드포인트별 데이터는 organic, images, news, videos, places, place 같은 결과 키에 들어갑니다.

status
필수
number

필수

비즈니스 상태 코드입니다. 0은 성공을 의미합니다.

request_id
필수
string

필수

지원, 재시도, 로그 추적에 사용하는 요청 ID입니다.

elapsed_ms
필수
number

필수

게이트웨이가 측정한 요청 실행 시간(ms)입니다.

credits_charged
필수
number | null

필수

환불 로직 적용 후 차감된 크레딧입니다.

search_type
선택
string

선택

제품에서 반환하는 경우의 제품별 응답 유형.

엔드포인트
1 credits
Search
/google/search

q, 언어 hl, 국가 gl 및 지원 기기로 Google 웹을 검색합니다. 결과 영역은 쿼리와 원본 응답에 따라 다릅니다.

1 credits
이미지 검색
/google/image/search

Google 이미지와 출처 링크를 검색합니다. 링크는 이미지 사용 권리를 부여하지 않습니다.

1 credits
뉴스 검색
/google/news/search

주제나 키워드로 Google 뉴스를 검색합니다. 기사와 발행자 필드는 원본 결과에 따라 다릅니다.

1 credits
동영상 검색
/google/videos/search

Google 동영상 목록을 검색합니다. 동영상 다운로드나 워터마크 제거 서비스가 아닙니다.

2 credits
지도 검색
/google/maps/search

쿼리와 위치로 Google Maps 장소를 찾습니다. 식별된 장소 상세는 별도 엔드포인트를 사용합니다.

3 credits
지도 상세
/google/maps/detail

장소 ID로 Google Maps 단일 장소를 조회합니다. 장소 검색을 보완하며 별도 요금이 적용됩니다.

2 credits
Google Maps Reviews
/google/maps/reviews

장소(data_id 지정)의 Google 지도 리뷰 첫 페이지를 가져옵니다. 평점, 내용, 날짜, 사진, 작성자 정보를 반환하며 사업주 답글은 아직 포함하지 않습니다.

1 credits
Google Search Autocomplete
/google/autocomplete

접두어로 Google 검색 제안을 가져옵니다. 검색량 측정값이 아닙니다.

2 credits
Google Shopping Search
/google/shopping

Google Shopping을 검색합니다. 시점 정보이며 지속적인 가격 모니터링이 아닙니다.

2 credits
Google Jobs Search
/google/jobs

직무나 키워드로 Google 채용을 검색합니다. 공고가 있을 때 반환하며 입사 지원을 제출하지 않습니다.

2 credits
Google Scholar Search
/google/scholar

주제나 키워드로 Google Scholar를 검색합니다. 메타데이터는 논문 전문 접근을 보장하지 않습니다.

1 credits
Google Books Search
/google/books

제목, 저자 또는 키워드로 Google Books를 검색합니다. 무제한 도서 다운로드는 포함되지 않습니다.

1 credits
Google Finance Search
/google/finance

회사나 금융 용어로 Google Finance를 조회합니다. 스트리밍 시세나 거래 API가 아닙니다.

2 credits
Google Patent Details
/google/patents/detail

공개 번호로 Google Patents 특허 1건을 가져옵니다. 제목, 요약, 청구항, 발명자, 출원인, 날짜를 반환합니다.

1 credits
Google Play Search
/google/play/search

키워드로 Google Play 앱을 검색해 앱 이름, 패키지 이름, 아이콘, 스토어 링크를 반환합니다. 앱을 다운로드하지는 않습니다.

1 credits
Google Play App Details
/google/play/app

패키지 이름으로 Google Play 앱 1개를 가져와 이름, 개발자, 설명, 가격, 버전, 출시일, 연령 등급을 반환합니다.

2 credits
Google Trends
/google/trends

Google 트렌드에서 최대 5개 키워드(쉼표 구분)의 시간별 관심도, 지역별 관심도, 관련 검색어를 가져옵니다.

2 credits
Google Trends Autocomplete
/google/trends/autocomplete

Google 트렌드에서 키워드와 관련된 주제 추천을 유형과 식별자와 함께 반환합니다.

2 credits
Google Trends Trending Now
/google/trends/trending

Google 트렌드에서 지정한 국가(기본값 미국)의 최근 24시간 급상승 검색어를 가져옵니다.

개발 중 · 일시 중지
Bing Web Search
/bing/search

Execute Bing web searches with query, country cc, and language setlang parameters for organic search results.

1 credits
DuckDuckGo Search
/duckduckgo/search

쿼리와 지원 시장·날짜 조건으로 DuckDuckGo HTML을 검색합니다. 다음 요청은 페이지 번호가 아닌 반환 커서를 사용합니다.

2 credits
Reddit Post & Comments
/reddit/post

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

1 credits
Reddit Search
/reddit/search

Search public Reddit posts and discussion threads across subreddits by keyword query.

2 credits
TikTok Post
/tiktok/post

게시물 ID와 사용자 이름으로 특정 TikTok 게시물을 조회합니다. 프로필 전체 게시물 탐색이 아닙니다.

2 credits
TikTok Profile
/tiktok/profile

사용자 이름으로 TikTok 프로필을 요청합니다. 원본 접근 가능 여부에 따라 다르며 시청자 이력 보관소가 아닙니다.

1 credits
TikTok Search
/tiktok/search

키워드로 TikTok 동영상을 검색합니다. 동영상 링크, 캡션, 작성자, 조회·좋아요·댓글·공유 수, 해시태그와 커버 이미지를 반환합니다(기본 페이지당 16개).

1 credits
X Post Details
/x/post

ID로 X 단일 게시물을 조회합니다. 키워드 검색, 타임라인 내보내기 또는 스트리밍이 아닙니다.

1 credits
YouTube Search
/youtube/search

Search YouTube videos, Shorts, and creator channels with query and region parameters.

2 credits
YouTube Video Transcripts
/youtube/transcripts

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

2 credits
Ajio Product Details
/ajio/product

HTTPS /p/ URL로 AJIO 단일 상품을 조회합니다. 카탈로그 내보내기가 아닙니다.

2 credits
Amazon Product Details
/amazon/product

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

2 credits
Amazon Product Reviews
/amazon/reviews

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

2 credits
Amazon Product Search
/amazon/search

Search Amazon product catalog by keyword query and domain. Returns structured product listings with prices, ratings, and Prime badges.

1 credits
Amazon Search Autocomplete
/amazon/autocomplete

접두어로 Amazon 검색 제안을 가져옵니다. 상품 상세나 가격 이력이 아닙니다.

1 credits
Apple Product Details
/apple/product

숫자 ID 또는 apps.apple.com URL과 국가로 App Store 앱을 조회합니다. Apple 하드웨어가 아닙니다.

2 credits
eBay Product Details
/ebay/product

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

1 credits
eBay Product Search
/ebay/search

Search eBay auction and Buy-It-Now listings by query. Returns titles, bids, prices, and seller information.

2 credits
Flipkart Product Details
/flipkart/product

/p/가 포함된 URL로 Flipkart 상품을 조회합니다. 검색어 대신 특정 URL을 입력하세요.

2 credits
Myntra Product Details
/myntra/product

/buy URL로 Myntra 단일 상품을 조회합니다. Myntra 검색과 별개입니다.

2 credits
Myntra Search
/myntra/search

쿼리나 지원 URL로 Myntra를 검색합니다. 페이지 번호는 지원하지만 커서나 페이지 크기 변경은 지원하지 않습니다.

2 credits
Walmart Product Details
/walmart/product

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

2 credits
Walmart Product Search
/walmart/search

Search Walmart retail inventory by keyword query. Returns product cards, prices, seller information, and stock status.

1 credits
Walmart Search Autocomplete
/walmart/autocomplete

쿼리로 Walmart 검색 제안을 가져옵니다. 상품 페이지를 조회하지 않습니다.

1 credits
User-Agent Generator
/web/user-agent

user_agent_type과 user_agent_count(1–5)로 데스크톱 또는 모바일 UA를 생성합니다. 로컬 작업이지만 카탈로그 요금이 적용됩니다.

1 credits
Web Crawl
/web/crawl

공개 사이트 URL에서 제한된 크롤링을 시작합니다. 요청당 고정 요금이며 반환 페이지 수를 곱하지 않습니다.

1 credits
Web Scrape
/web/scrape

공개 HTTP/HTTPS 페이지를 URL로 추출합니다. 텍스트, HTML, Markdown 및 선택자를 지원하며 출처 제한은 적용됩니다. Google 페이지는 지원하지 않으므로 /google/search 등 Google 엔드포인트를 사용하세요.

2 credits
Zillow Property Search
/zillow/search

지원 Zillow homes URL로 검색 결과를 조회합니다. 매물 시점 정보이며 감정가나 거래 피드가 아닙니다.

POST
사용 가능
/google/image/search

이미지 검색

Google 이미지와 출처 링크를 검색합니다. 링크는 이미지 사용 권리를 부여하지 않습니다.

type
images
result
images
과금
1 credits

Google 이미지와 출처 링크를 검색합니다. 링크는 이미지 사용 권리를 부여하지 않습니다.

파라미터
q
필수
string

필수

검색 쿼리 문자열입니다.

hl
선택
string

선택

언어 코드입니다. 기본값은 en입니다.

gl
선택
string

선택

국가 코드입니다. 기본값은 us입니다.

page
선택
number

선택

1부터 시작하는 페이지 번호입니다. 기본값은 1입니다.

query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "red pandas"

json
{
  "query": "red pandas"
}
Playground에서 실행
응답 필드
query
필수
string

필수

요청에서 정규화된 쿼리입니다.

page
필수
number

필수

현재 페이지 번호입니다. 1부터 시작합니다.

images
선택
ImageResult[]

이미지 결과가 파싱된 경우.

Google 이미지 검색 결과.

ImageResult 결과 항목 구조
rank
필수
number

필수

이 응답 안에서 1부터 시작하는 순위입니다.

position
선택
number

제공되는 경우 rank의 별칭입니다.

position 필드를 기대하는 클라이언트용 정규화 순위입니다.

title
선택
string

이미지 제목 또는 alt 텍스트를 파싱할 수 있을 때 반환됩니다.

결과 제목입니다.

link
필수
string

필수

파서가 반환하는 기본 링크입니다.

url
선택
string

결과 링크를 정규화할 수 있을 때 반환됩니다.

정규화된 대상 URL이며 보통 link와 같습니다.

source_url
선택
string

Google 리다이렉트/원본 URL이 관측된 경우에만 반환됩니다.

디버깅과 출처 확인을 위해 보존되는 원본 Google URL입니다.

display_url
선택
string

Google 표시 텍스트나 도메인을 추출할 수 있을 때 반환됩니다.

표시 URL 또는 출처 도메인입니다.

image_url
필수
string

필수

전체 이미지 URL.

thumbnail_url
선택
string

Google이 썸네일을 제공할 때 반환됩니다.

썸네일 URL입니다.

thumbnail
선택
string

제공되는 경우 thumbnail_url의 별칭입니다.

정규화된 썸네일 별칭입니다.

source
선택
string

출처 텍스트가 파싱된 경우.

이미지 출처 라벨.

domain
선택
string

원본 페이지 도메인을 도출할 수 있는 경우.

원본 페이지 도메인.

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/image/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"red pandas"}'
기존 Google 요청 예시
bash
curl -X POST https://api.serpbase.dev/google/image/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "iphone 15 pro blue",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
참고

비주얼 검색, 상품 모니터링, 이미지 출처 탐색.

일부 Google 이미지 형식은 rank/link만 제공하고 모든 정규화 별칭은 제공하지 않습니다. url, display_url, source_url, position, thumbnail은 선택 필드입니다.

POST
사용 가능
/google/news/search

뉴스 검색

주제나 키워드로 Google 뉴스를 검색합니다. 기사와 발행자 필드는 원본 결과에 따라 다릅니다.

type
news
result
news
과금
1 credits

주제나 키워드로 Google 뉴스를 검색합니다. 기사와 발행자 필드는 원본 결과에 따라 다릅니다.

파라미터
q
필수
string

필수

검색 쿼리 문자열입니다.

hl
선택
string

선택

언어 코드입니다. 기본값은 en입니다.

gl
선택
string

선택

국가 코드입니다. 기본값은 us입니다.

page
선택
number

선택

1부터 시작하는 페이지 번호입니다. 기본값은 1입니다.

query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
Playground에서 실행
응답 필드
query
필수
string

필수

요청에서 정규화된 쿼리입니다.

page
필수
number

필수

현재 페이지 번호입니다. 1부터 시작합니다.

news
선택
NewsResult[]

뉴스 결과가 파싱된 경우.

Google 뉴스 결과.

NewsResult 결과 항목 구조
rank
필수
number

필수

이 응답 안에서 1부터 시작하는 순위입니다.

position
선택
number

제공되는 경우 rank의 별칭입니다.

position 필드를 기대하는 클라이언트용 정규화 순위입니다.

title
필수
string

필수

결과 제목입니다.

link
필수
string

필수

파서가 반환하는 기본 링크입니다.

url
선택
string

결과 링크를 정규화할 수 있을 때 반환됩니다.

정규화된 대상 URL이며 보통 link와 같습니다.

source_url
선택
string

Google 리다이렉트/원본 URL이 관측된 경우에만 반환됩니다.

디버깅과 출처 확인을 위해 보존되는 원본 Google URL입니다.

display_url
선택
string

Google 표시 텍스트나 도메인을 추출할 수 있을 때 반환됩니다.

표시 URL 또는 출처 도메인입니다.

source
선택
string

발행자 텍스트가 파싱된 경우.

발행자/출처 라벨.

time
선택
string

Google이 시간 텍스트를 제공하는 경우.

게시 시간 원문.

published_at
선택
string

파싱된 시간이 있으면 해당 별칭.

정규화된 게시 시간 별칭.

snippet
선택
string

스니펫이 파싱된 경우.

기사 요약 스니펫.

thumbnail_url
선택
string

Google이 썸네일을 제공할 때 반환됩니다.

썸네일 URL입니다.

thumbnail
선택
string

제공되는 경우 thumbnail_url의 별칭입니다.

정규화된 썸네일 별칭입니다.

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
기존 Google 요청 예시
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
참고

브랜드 모니터링, 트렌드 추적, 미디어 탐색.

출처와 시간은 Google 메타데이터 텍스트에서 파싱하므로 모두 선택 필드로 처리하세요.

POST
사용 가능
/google/videos/search

동영상 검색

Google 동영상 목록을 검색합니다. 동영상 다운로드나 워터마크 제거 서비스가 아닙니다.

type
videos
result
videos
과금
1 credits

Google 동영상 목록을 검색합니다. 동영상 다운로드나 워터마크 제거 서비스가 아닙니다.

파라미터
q
필수
string

필수

검색 쿼리 문자열입니다.

hl
선택
string

선택

언어 코드입니다. 기본값은 en입니다.

gl
선택
string

선택

국가 코드입니다. 기본값은 us입니다.

page
선택
number

선택

1부터 시작하는 페이지 번호입니다. 기본값은 1입니다.

query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "how espresso machines work"

json
{
  "query": "how espresso machines work"
}
Playground에서 실행
응답 필드
query
필수
string

필수

요청에서 정규화된 쿼리입니다.

page
필수
number

필수

현재 페이지 번호입니다. 1부터 시작합니다.

videos
선택
VideoResult[]

동영상 결과가 파싱된 경우.

Google 동영상 검색 결과.

VideoResult 결과 항목 구조
rank
필수
number

필수

이 응답 안에서 1부터 시작하는 순위입니다.

position
선택
number

제공되는 경우 rank의 별칭입니다.

position 필드를 기대하는 클라이언트용 정규화 순위입니다.

title
필수
string

필수

결과 제목입니다.

link
필수
string

필수

파서가 반환하는 기본 링크입니다.

url
선택
string

결과 링크를 정규화할 수 있을 때 반환됩니다.

정규화된 대상 URL이며 보통 link와 같습니다.

source_url
선택
string

Google 리다이렉트/원본 URL이 관측된 경우에만 반환됩니다.

디버깅과 출처 확인을 위해 보존되는 원본 Google URL입니다.

display_url
선택
string

Google 표시 텍스트나 도메인을 추출할 수 있을 때 반환됩니다.

표시 URL 또는 출처 도메인입니다.

source
선택
string

출처/채널을 파싱할 수 있는 경우.

동영상 출처 또는 채널 라벨.

duration
선택
string

결과 텍스트에 길이가 있는 경우.

동영상 길이 텍스트.

time
선택
string

게시 시간을 파싱할 수 있는 경우.

게시 시간 원문.

published_at
선택
string

파싱된 시간이 있으면 해당 별칭.

정규화된 게시 시간 별칭.

thumbnail_url
선택
string

Google이 썸네일을 제공할 때 반환됩니다.

썸네일 URL입니다.

thumbnail
선택
string

제공되는 경우 thumbnail_url의 별칭입니다.

정규화된 썸네일 별칭입니다.

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/videos/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"how espresso machines work"}'
기존 Google 요청 예시
bash
curl -X POST https://api.serpbase.dev/google/videos/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio tutorial",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
참고

동영상 검색, 튜토리얼 탐색, 미디어 모니터링.

전용 동영상 카드가 없으면 호환 Google 레이아웃에서 뉴스 형식 추출을 사용합니다.

POST
사용 가능
/google/maps/detail

지도 상세

장소 ID로 Google Maps 단일 장소를 조회합니다. 장소 검색을 보완하며 별도 요금이 적용됩니다.

type
maps_detail
result
place
과금
3 credits

장소 ID로 Google Maps 단일 장소를 조회합니다. 장소 검색을 보완하며 별도 요금이 적용됩니다.

파라미터
feature_id
필수
string

필수

Maps Search 장소 결과의 feature_id 필드를 사용합니다. 형식은 0x...:0x... 입니다.

hl
선택
string

선택

언어 코드입니다. 기본값은 en입니다.

gl
선택
string

선택

국가 코드입니다. 기본값은 us입니다.

id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json
{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}
Playground에서 실행
응답 필드
feature_id
필수
string

필수

지도 상세 요청에서 확인한 feature_id.

page
필수
number

필수

지도 상세에서는 항상 1.

place
선택
MapsPlace

장소 상세가 파싱된 경우.

단일 장소 상세 객체.

MapsPlace 결과 항목 구조
position
선택
number

Maps 검색 전용.

지역 결과의 장소 순위.

name
필수
string

필수

장소 이름.

title
필수
string

필수

name의 별칭.

feature_id
필수
string

필수

Google Maps feature ID.

place_id
선택
string

Google이 제공하는 경우.

Google 장소 ID.

data_id
선택
string

feature_id의 별칭.

Maps 데이터 ID.

cid
선택
string

가능하면 feature_id에서 도출.

Google CID 값.

kgmid
선택
string

Maps 데이터에 있는 경우.

지식 그래프 머신 ID.

google_maps_url
선택
string

Google이 Maps URL을 제공하는 경우.

Google Maps URL 주소.

url
선택
string

google_maps_url, 없으면 website.

장소 기본 URL.

rating
선택
number

평점이 있는 경우.

Google 평점.

types
선택
string[]

카테고리가 있는 경우.

장소 유형 라벨.

category
선택
object

카테고리가 파싱된 경우.

구조화된 카테고리 데이터.

address
선택
string

주소가 있는 경우.

서식이 지정된 주소.

address_components
선택
object

주소 구성 요소가 있는 경우.

거리, 도시, 우편번호, 국가 코드.

plus_code
선택
object

Plus Code가 있는 경우.

전역 및 복합 Plus Code.

phone
선택
string

전화번호가 있는 경우.

지역 전화번호.

phone_international
선택
string

있는 경우.

국제 전화번호.

phone_uri
선택
string

있는 경우.

전화 URI.

website
선택
string

웹사이트가 있는 경우.

업체 웹사이트.

website_domain
선택
string

사이트 도메인이 있는 경우.

업체 사이트 도메인.

latitude
선택
number

좌표가 있는 경우.

위도.

longitude
선택
number

좌표가 있는 경우.

경도.

image
선택
string

이미지가 있는 경우.

장소 기본 이미지.

thumbnail
선택
string

이미지가 있으면 image 별칭.

기본 이미지 별칭.

photos
선택
MapsPhoto[]

사진이 파싱된 경우.

사진 ID, URL, 크기 및 선택적 좌표.

hours
선택
Record<string,string>

영업시간이 파싱된 경우.

요일별 영업시간.

open_status
선택
object

영업 상태가 있는 경우.

영업 상태 및 현재 영업시간.

attributes
선택
object[]

속성이 파싱된 경우.

그룹화된 장소 속성.

related_places
선택
object[]

관련 장소가 있는 경우.

Maps 데이터의 관련 장소.

short_description
선택
string

설명 블록이 있는 경우.

짧은 장소 설명.

description
선택
string

설명 블록이 있는 경우.

상세 장소 설명.

snippet
선택
string

short_description, 없으면 description.

정규화된 텍스트 요약.

timezone
선택
string

있는 경우.

장소 시간대.

region
선택
string

있는 경우.

지역 라벨.

country_code
선택
string

있는 경우.

국가 코드.

language
선택
string

있는 경우.

Maps 데이터의 언어 코드.

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/maps/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'
기존 Google 요청 예시
bash
curl -X POST https://api.serpbase.dev/google/maps/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
    "hl": "en",
    "gl": "us"
  }'
참고

장소 정보 보강, 로컬 CRM 데이터, 상세 페이지.

Maps 검색 결과의 feature_id로 상세를 요청하세요. 형식이 올바르지만 알 수 없는 feature_id는 status 1004를 반환합니다.

POST
사용 가능
/google/maps/reviews

Google Maps Reviews

장소(data_id 지정)의 Google 지도 리뷰 첫 페이지를 가져옵니다. 평점, 내용, 날짜, 사진, 작성자 정보를 반환하며 사업주 답글은 아직 포함하지 않습니다.

type
google_maps_reviews
result
schemas.source_data
과금
2 credits

장소(data_id 지정)의 Google 지도 리뷰 첫 페이지를 가져옵니다. 평점, 내용, 날짜, 사진, 작성자 정보를 반환하며 사업주 답글은 아직 포함하지 않습니다.

파라미터
data_id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

dataID
선택
string

선택

data_id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

google_domain
선택
string

선택

locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gooogle_domain
선택
string

선택

locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

next_page_token
선택
string

선택

next_token: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

results
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

topic_id
선택
string

선택

attributes.topic_id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "data_id": "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/maps/reviews' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"data_id":"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/google/autocomplete

Google Search Autocomplete

접두어로 Google 검색 제안을 가져옵니다. 검색량 측정값이 아닙니다.

type
google_autocomplete
result
schemas.autocomplete
과금
1 credits

접두어로 Google 검색 제안을 가져옵니다. 검색량 측정값이 아닙니다.

파라미터
query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "weather"

json
{
  "query": "weather"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.autocomplete

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"weather"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/google/patents/detail

Google Patent Details

공개 번호로 Google Patents 특허 1건을 가져옵니다. 제목, 요약, 청구항, 발명자, 출원인, 날짜를 반환합니다.

type
google_patents_detail
result
schemas.source_data
과금
2 credits

공개 번호로 Google Patents 특허 1건을 가져옵니다. 제목, 요약, 청구항, 발명자, 출원인, 날짜를 반환합니다.

파라미터
id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "US8244737B2"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

google_domain
선택
string

선택

locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gooogle_domain
선택
string

선택

locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

lanaguage
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

patent_id
선택
string

선택

id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

results
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "id": "US8244737B2"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/patents/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"US8244737B2"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/google/play/app

Google Play App Details

패키지 이름으로 Google Play 앱 1개를 가져와 이름, 개발자, 설명, 가격, 버전, 출시일, 연령 등급을 반환합니다.

type
google_play_app
result
schemas.source_data
과금
1 credits

패키지 이름으로 Google Play 앱 1개를 가져와 이름, 개발자, 설명, 가격, 버전, 출시일, 연령 등급을 반환합니다.

파라미터
id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "com.spotify.music"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

google_domain
선택
string

선택

locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gooogle_domain
선택
string

선택

locale.engine_domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

results
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "id": "com.spotify.music"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/play/app' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"com.spotify.music"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/reddit/post

Reddit Post & Comments

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

type
reddit_post
result
schemas.source_data
과금
2 credits

Retrieve full Reddit post content, author details, upvotes, and structured comment threads from a Reddit post URL.

파라미터
url
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "url": "https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/reddit/post' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.reddit.com/r/technology/comments/1example/new_ai_breakthrough/"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/tiktok/post

TikTok Post

게시물 ID와 사용자 이름으로 특정 TikTok 게시물을 조회합니다. 프로필 전체 게시물 탐색이 아닙니다.

type
tiktok_post
result
schemas.source_data
과금
2 credits

게시물 ID와 사용자 이름으로 특정 TikTok 게시물을 조회합니다. 프로필 전체 게시물 탐색이 아닙니다.

파라미터
id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "7123456789012345678"

username
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "tiktok"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

post_id
선택
string

선택

id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "id": "7123456789012345678",
  "username": "tiktok"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/tiktok/post' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"7123456789012345678","username":"tiktok"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/tiktok/profile

TikTok Profile

사용자 이름으로 TikTok 프로필을 요청합니다. 원본 접근 가능 여부에 따라 다르며 시청자 이력 보관소가 아닙니다.

type
tiktok_profile
result
schemas.source_data
과금
2 credits

사용자 이름으로 TikTok 프로필을 요청합니다. 원본 접근 가능 여부에 따라 다르며 시청자 이력 보관소가 아닙니다.

파라미터
username
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "tiktok"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "username": "tiktok"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/tiktok/profile' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"username":"tiktok"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/x/post

X Post Details

ID로 X 단일 게시물을 조회합니다. 키워드 검색, 타임라인 내보내기 또는 스트리밍이 아닙니다.

type
x_post
result
schemas.source_data
과금
1 credits

ID로 X 단일 게시물을 조회합니다. 키워드 검색, 타임라인 내보내기 또는 스트리밍이 아닙니다.

파라미터
id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "1234567890123456789"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

tweetId
선택
string

선택

id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "id": "1234567890123456789"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/x/post' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"1234567890123456789"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/youtube/transcripts

YouTube Video Transcripts

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

type
youtube_transcripts
result
schemas.source_data
과금
2 credits

Extract timestamped multi-language video transcripts and closed captions for a YouTube video ID.

파라미터
id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "dQw4w9WgXcQ"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

v
선택
string

선택

id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

video_link
선택
string

선택

url: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "id": "dQw4w9WgXcQ"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/youtube/transcripts' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"dQw4w9WgXcQ"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/ajio/product

Ajio Product Details

HTTPS /p/ URL로 AJIO 단일 상품을 조회합니다. 카탈로그 내보내기가 아닙니다.

type
ajio_product
result
schemas.source_data
과금
2 credits

HTTPS /p/ URL로 AJIO 단일 상품을 조회합니다. 카탈로그 내보내기가 아닙니다.

파라미터
url
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "https://www.ajio.com/sample/p/1234567890"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "url": "https://www.ajio.com/sample/p/1234567890"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/ajio/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.ajio.com/sample/p/1234567890"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/amazon/product

Amazon Product Details

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

type
amazon_product
result
schemas.source_data
과금
2 credits

Retrieve detailed Amazon product data including titles, multiple variant ASINs, merchant offers, availability, and specs by ASIN.

파라미터
asin
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "B08N5WRWNW"

domain
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "amazon.com"

amazon_domain
선택
string

선택

domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

type
선택
string

선택

search_type: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "asin": "B08N5WRWNW",
  "domain": "amazon.com"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/amazon/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/amazon/reviews

Amazon Product Reviews

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

type
amazon_reviews
result
schemas.source_data
과금
2 credits

Extract authentic customer reviews, star ratings, review text, and reviewer attributes for an Amazon product ASIN.

파라미터
asin
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "B08N5WRWNW"

domain
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "amazon.com"

amazon_domain
선택
string

선택

domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

filter_by_star
선택
string

선택

review_rating: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

reviewer_type
선택
string

선택

review_type: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

type
선택
string

선택

search_type: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "asin": "B08N5WRWNW",
  "domain": "amazon.com"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/amazon/reviews' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"asin":"B08N5WRWNW","domain":"amazon.com"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/amazon/autocomplete

Amazon Search Autocomplete

접두어로 Amazon 검색 제안을 가져옵니다. 상품 상세나 가격 이력이 아닙니다.

type
amazon_autocomplete
result
schemas.source_data
과금
1 credits

접두어로 Amazon 검색 제안을 가져옵니다. 상품 상세나 가격 이력이 아닙니다.

파라미터
prefix
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "laptop"

amazon_domain
선택
string

선택

domain: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mid
선택
string

선택

marketplace_id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

type
선택
string

선택

search_type: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "prefix": "laptop"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/amazon/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"prefix":"laptop"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/apple/product

Apple Product Details

숫자 ID 또는 apps.apple.com URL과 국가로 App Store 앱을 조회합니다. Apple 하드웨어가 아닙니다.

type
apple_product
result
schemas.source_data
과금
1 credits

숫자 ID 또는 apps.apple.com URL과 국가로 App Store 앱을 조회합니다. Apple 하드웨어가 아닙니다.

파라미터
id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "284882215"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

product_id
선택
string

선택

id: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

type
선택
string

선택

search_type: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "id": "284882215"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/apple/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"284882215"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/ebay/product

eBay Product Details

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

type
ebay_product
result
schemas.source_data
과금
2 credits

Retrieve detailed eBay item data, current auction prices, seller ratings, and listing specifications by item ID.

파라미터
domain
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "ebay.com"

id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "123456789012"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "domain": "ebay.com",
  "id": "123456789012"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/ebay/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"domain":"ebay.com","id":"123456789012"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/flipkart/product

Flipkart Product Details

/p/가 포함된 URL로 Flipkart 상품을 조회합니다. 검색어 대신 특정 URL을 입력하세요.

type
flipkart_product
result
schemas.source_data
과금
2 credits

/p/가 포함된 URL로 Flipkart 상품을 조회합니다. 검색어 대신 특정 URL을 입력하세요.

파라미터
url
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "https://www.flipkart.com/item/p/itm1234567890"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "url": "https://www.flipkart.com/item/p/itm1234567890"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/flipkart/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.flipkart.com/item/p/itm1234567890"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/myntra/product

Myntra Product Details

/buy URL로 Myntra 단일 상품을 조회합니다. Myntra 검색과 별개입니다.

type
myntra_product
result
schemas.source_data
과금
2 credits

/buy URL로 Myntra 단일 상품을 조회합니다. Myntra 검색과 별개입니다.

파라미터
url
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "https://www.myntra.com/shoes/nike/123456/buy"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "url": "https://www.myntra.com/shoes/nike/123456/buy"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/myntra/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://www.myntra.com/shoes/nike/123456/buy"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/walmart/product

Walmart Product Details

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

type
walmart_product
result
schemas.source_data
과금
2 credits

Extract full Walmart product specification, pricing, variant details, and descriptions using Walmart item ID.

파라미터
id
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "133497934"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "id": "133497934"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/walmart/product' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"133497934"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/walmart/autocomplete

Walmart Search Autocomplete

쿼리로 Walmart 검색 제안을 가져옵니다. 상품 페이지를 조회하지 않습니다.

type
walmart_autocomplete
result
schemas.source_data
과금
1 credits

쿼리로 Walmart 검색 제안을 가져옵니다. 상품 페이지를 조회하지 않습니다.

파라미터
query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "laptop"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "query": "laptop"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/walmart/autocomplete' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"laptop"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/web/user-agent

User-Agent Generator

user_agent_type과 user_agent_count(1–5)로 데스크톱 또는 모바일 UA를 생성합니다. 로컬 작업이지만 카탈로그 요금이 적용됩니다.

type
web_user_agent
result
schemas.source_data
과금
1 credits

user_agent_type과 user_agent_count(1–5)로 데스크톱 또는 모바일 UA를 생성합니다. 로컬 작업이지만 카탈로그 요금이 적용됩니다.

파라미터
user_agent_count
예시
number

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: 1

user_agent_type
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "desktop"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

uanum
선택
integer

선택

user_agent_count: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

uatype
선택
string

선택

user_agent_type: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "user_agent_count": 1,
  "user_agent_type": "desktop"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/web/user-agent' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"user_agent_count":1,"user_agent_type":"desktop"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/web/crawl

Web Crawl

공개 사이트 URL에서 제한된 크롤링을 시작합니다. 요청당 고정 요금이며 반환 페이지 수를 곱하지 않습니다.

type
web_crawl
result
schemas.source_data
과금
1 credits

공개 사이트 URL에서 제한된 크롤링을 시작합니다. 요청당 고정 요금이며 반환 페이지 수를 곱하지 않습니다.

파라미터
url
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "https://example.com"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "url": "https://example.com"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/web/crawl' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://example.com"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

POST
사용 가능
/web/scrape

Web Scrape

공개 HTTP/HTTPS 페이지를 URL로 추출합니다. 텍스트, HTML, Markdown 및 선택자를 지원하며 출처 제한은 적용됩니다. Google 페이지는 지원하지 않으므로 /google/search 등 Google 엔드포인트를 사용하세요.

type
web_scrape
result
schemas.source_data
과금
1 credits

공개 HTTP/HTTPS 페이지를 URL로 추출합니다. 텍스트, HTML, Markdown 및 선택자를 지원하며 출처 제한은 적용됩니다. Google 페이지는 지원하지 않으므로 /google/search 등 Google 엔드포인트를 사용하세요.

파라미터
url
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "https://example.com"

country
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

cursor
선택
string

선택

pagination.cursor: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

custom_headers
선택
object

선택

headers: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

device
선택
string

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

gl
선택
string

선택

locale.country: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

hl
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

html
선택
boolean

선택

include_html: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

language
선택
string

선택

locale.language: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

limit
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

markdown
선택
boolean

선택

include_markdown: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

mobile
선택
boolean

선택

options.device: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

num
선택
integer

선택

pagination.limit: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

page
선택
integer

선택

pagination.page: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

q
선택
string

선택

query: 별칭은 한 번에 하나의 표기만 사용하세요. API는 지원 매개변수와 값을 검증합니다.

json
{
  "url": "https://example.com"
}
Playground에서 실행

응답은 제품 계약을 따릅니다. 기록된 응답 예시는 아직 공개되지 않았습니다.schemas.source_data

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/web/scrape' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"url":"https://example.com"}'
참고

카탈로그 예시로 시작하고 실제 JSON 응답을 확인하세요.

예시는 전체 요청 계약이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.

오류
error
필수
string

필수

사람이 읽을 수 있는 오류 메시지입니다.

0
SUCCESS

요청이 성공했습니다. 제품별 결과 필드를 확인하세요. no_results만으로 HTTP 404를 입증하지 못합니다.

과금됨

1000
INVALID_REQUEST

본문 또는 매개변수가 없거나 잘못되었습니다.

과금 없음요청을 먼저 수정

1001
UNAUTHORIZED

API 키가 없거나 잘못되었거나 폐기되었습니다.

과금 없음요청을 먼저 수정

1004
NOT_FOUND

게이트웨이 라우팅 또는 카탈로그에 리소스가 없습니다.

과금 없음요청을 먼저 수정

1020
INSUFFICIENT_CREDITS

계정 잔액이 부족합니다.

과금 없음요청을 먼저 수정

1029
RATE_LIMITED

QPS 또는 동시 실행 한도를 초과했습니다.

과금 없음재시도 가능

1500
INTERNAL_ERROR

예기치 않은 내부 서버 오류.

과금 없음재시도 가능

1502
UPSTREAM_FAILED

워커가 원본 가져오기 또는 파싱 오류를 반환했습니다.

과금 없음재시도 가능

1503
SERVICE_UNAVAILABLE

사용 가능한 워커 세션이 없습니다.

과금 없음재시도 가능

1504
UPSTREAM_TIMEOUT

게이트웨이의 워커 결과 대기 시간이 초과되었습니다.

과금 없음재시도 가능

json
{
  "status": 1001,
  "error": "unauthorized",
  "request_id": "0f3576b2-6e2e-4f1e-bb0e-8cb0d4a60195",
  "elapsed_ms": 0,
  "credits_charged": 0
}
응답 헤더

모든 제품 응답에 이 헤더가 포함되어 메시지를 파싱하지 않고도 속도를 조절하고 재시도 여부를 판단할 수 있습니다.

X-RateLimit-Limit
계정에 허용된 초당 요청 수.
X-RateLimit-Remaining
현재 초에 남은 요청 수.
Retry-After
거부 시 다시 보내기 전에 기다릴 초.
X-SerpBase-Retryable
true면 같은 요청을 다시 보내 성공할 수 있고, false면 요청 자체를 바꿔야 합니다.
지원팀에 문의할 때
응답의 request_id(성공과 실패 모두 포함)와 호출 시각을 함께 보내 주세요. 그러면 해당 요청을 몇 초 만에 찾을 수 있습니다.
개인정보 및 보존
검색어는 과금, 디버깅, 남용 방지, 계정 로그를 위해 기록될 수 있습니다. 보존 정보는 개인정보 페이지를 확인하세요.