웹 수집사용 가능

Web Scrape

공개 HTTP/HTTPS 페이지를 URL로 추출합니다. 텍스트, HTML, Markdown 및 선택자를 지원하며 출처 제한은 적용됩니다.

각 엔드포인트의 요청 예시, 파라미터, 요청당 가격을 확인하세요. API 키 하나로 모두 호출할 수 있으며 계정 한도가 적용됩니다.

API 레퍼런스 Playground에서 실행

한눈에 보기

엔드포인트: POST https://api.serpbase.dev/web/scrape
가격: 1 크레딧 / 요청
인증: X-API-Key
결과 유형: schemas.source_data

엔드포인트 및 과금 규칙

POSThttps://api.serpbase.dev/web/scrape

요청당 비용

1 크레딧 / 요청

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

요청 매개변수 예시

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

요청 매개변수 예시
매개변수	예시 유형	예시 값
url	string	"https://example.com"

JSON

{
  "url": "https://example.com"
}

예시는 전체 매개변수나 필수 규칙이 아닙니다. 알려진 필드는 검증되며 추가 매개변수는 허용됩니다.
별칭	매개변수	유형
country	locale.country	string
cursor	pagination.cursor	string
custom_headers	headers	object
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string

지원 기기: desktop; 기본값: desktop.

요청 예시

cURL

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"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/web/scrape", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"url\":\"https://example.com\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

응답 및 API 결과

응답은 JSON입니다. HTTP 200은 검색 성공을 보장하지 않습니다. status와 error를 확인하세요. 필드는 제품 계약과 원본 데이터에 따라 다릅니다.

응답 문서 보기

자주 묻는 질문

Web Scrape API 요금은 얼마인가요?

요청 1회에 1 크레딧이 사용됩니다. 크레딧은 선불 팩이나 월간 플랜으로 구매하며, 새 계정에는 무료 크레딧이 제공됩니다.

Web Scrape API는 어떻게 호출하나요?

https://api.serpbase.dev/web/scrape에 POST 요청을 보내고 X-API-Key 헤더에 API 키를 넣으세요. 응답은 JSON이며 status(0은 성공)를 확인하세요.

어떤 기기를 지원하나요?

지원 기기: desktop. 기본값은 desktop입니다.

Web Scrape API를 지금 사용할 수 있나요?

네. 활성 API 키라면 누구나 호출할 수 있습니다.