KYC 없이 — 신분증, 셀피, 서류 없음. 암호화폐로 결제: BTC, USDT, USDC, ETH, SOL, LTC
언어: 한국어
API 키 발급

문서 · 빠른 시작 · API v1

SERP API 빠른 시작: curl, Python, Node.js로 하는 첫 검색

HTTPS endpoint 하나, API 키 하나, 성공한 검색 한 번당 크레딧 하나. 이 페이지에서는 빈 계정에서 파싱된 구글 검색 결과 페이지까지 안내한 뒤, 나머지 모든 내용은 레퍼런스로 안내합니다.

마지막 업데이트: · 5 분 소요

빠른 답변

SerpCrypto로 첫 SERP API 요청을 어떻게 보내나요?

크레딧 팩을 구매하고, 대시보드에서 API 키를 복사한 뒤 Authorization: Bearer YOUR_KEY 헤더와 함께 GET https://serpcrypto.com/api/v1/search?q=your+query을 보내세요. SerpCrypto이 결과 페이지를 JSON으로 응답하고, 검색이 성공할 때만 크레딧 1개를 차감합니다. 검색 10,000회의 비용은 US$7.50이며, KYC 없이 암호화폐로 결제하고 크레딧은 만료되지 않습니다.

API 한눈에 보기

기본 URLhttps://serpcrypto.com/api/v1
검색GET https://serpcrypto.com/api/v1/search
크레딧GET https://serpcrypto.com/api/v1/credits (무료)
인증Authorization 헤더(Bearer) 또는 api_key 쿼리 파라미터에 API 키를 넣습니다
엔진Google 검색, Google 뉴스, Google 이미지, Google 지도(로컬 결과), Google 쇼핑 및 Bing
과금1 크레딧 = 성공한 검색 요청 1건이며, 지원되는 모든 엔진에서 결과 한 페이지를 반환합니다. 실패한 요청은 과금되지 않습니다
크레딧 만료선불 검색 크레딧은 만료되지 않습니다: 사용하지 않은 검색은 사용할 때까지 계정에 남아 있습니다
형식HTTPS 기반 JSON, UTF-8

API 키는 어떻게 받나요?

네 단계입니다. 신분증도, 셀카도, 서류도 필요 없고, 원하지 않으면 이메일도 필요 없습니다.

  1. 계정 만들기

    계정 번호로 로그인하며 이메일은 선택 사항입니다. 계정 번호를 비밀번호 관리자에 저장하세요. 이 번호가 로그인 정보입니다.

  2. 암호화폐로 충전하기

    BTC, USDT, USDC, ETH, SOL, LTC로 최소 US$25을 보내세요. 잔액은 결제 페이지에 안내된 네트워크 확인 수를 거친 뒤 충전됩니다.

  3. 크레딧 팩 구매하기

    US$7.50에 검색 10,000회이면 모든 엔진을 테스트하기에 충분합니다. 더 큰 팩은 요금을 US$0.30/1K 검색까지 낮춥니다. 가격을 참고하세요.

  4. 키 복사하기

    확인된 암호화폐 잔액으로 크레딧 팩을 구매하면 API 키가 즉시 대시보드에 표시됩니다. SERPCRYPTO_API_KEY라는 이름의 환경 변수에 보관하고, 코드 저장소에는 절대 두지 마세요.

curl로 첫 검색을 어떻게 실행하나요?

키를 한 번 export한 뒤 GET 요청 하나를 보내세요. --data-urlencode과 함께 쓰는 -G 플래그는 쿼리 문자열을 만들고 공백과 악센트를 대신 인코딩해 줍니다. 응답은 JSON 문서 하나이며, jq를 쓰면 터미널에서 읽기 좋게 유지됩니다.

이 예제는 기본 엔진인 Google에 영어로 미국 결과를 요청합니다. q, gl 또는 hl를 바꿔 다시 실행해 보세요. 성공한 실행마다 크레딧 하나를 사용합니다.

curl + jq: 처음 세 개의 유기적 검색 결과
export SERPCRYPTO_API_KEY="paste-your-key-here"

curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=best espresso grinder" \
  -d gl=us -d hl=en | jq '.organic_results[:3]'

같은 검색을 Python에서 어떻게 실행하나요?

아무 HTTP 클라이언트나 사용하세요. requests에서는 파라미터를 딕셔너리로, 키를 헤더로 전달합니다. raise_for_status()은 잘못된 키에 대한 401 같은 오류 응답을 잡을 수 있는 예외로 바꿔 줍니다.

Python 3.9+ 및 requests
import os

import requests

API_URL = "https://serpcrypto.com/api/v1/search"
API_KEY = os.environ["SERPCRYPTO_API_KEY"]

response = requests.get(
    API_URL,
    params={"q": "best espresso grinder", "gl": "us", "hl": "en"},
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=60,
)
response.raise_for_status()
data = response.json()

print("credits used:", data["search_metadata"]["credits_used"])
for result in data.get("organic_results", [])[:3]:
    print(result["position"], result["title"], result["link"])

Node.js에서는 어떻게 하나요?

Node.js 18 이상에는 fetch이 기본 포함되어 있어 패키지가 필요 없습니다. 파일을 .mjs 확장자로 저장해 최상위에서 await를 사용한 다음 node first-search.mjs을 실행하세요.

내장 fetch가 있는 Node.js 18+
// first-search.mjs (Node.js 18 or later: fetch and top-level await are built in)
const API_URL = "https://serpcrypto.com/api/v1/search";
const params = new URLSearchParams({ q: "best espresso grinder", gl: "us", hl: "en" });

const response = await fetch(`${API_URL}?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPCRYPTO_API_KEY}` },
});
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
const data = await response.json();

console.log("credits used:", data.search_metadata.credits_used);
for (const result of (data.organic_results ?? []).slice(0, 3)) {
  console.log(result.position, result.title, result.link);
}

남은 크레딧이 얼마인지 어떻게 확인하나요?

동일한 키로 GET https://serpcrypto.com/api/v1/credits을 호출합니다. 무료이며 세 가지 숫자를 반환합니다: 남은 크레딧, 오늘 사용한 크레딧, 계정이 동시에 실행할 수 있는 검색 수입니다. 각 계정은 동시에 정해진 수의 검색을 실행할 수 있으며, 한도는 대시보드에 표시되고 요청 시 상향됩니다.

크레딧 조회
curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY"
응답 (예시 값)
{
  "credits_remaining": 84210,
  "credits_used_today": 1290,
  "concurrency_limit": 10
}

검색에서 무엇이 반환되나요?

모든 엔진에서 모든 응답은 동일한 구조를 가집니다. search_metadata은 검색 성공 여부와 사용된 크레딧 수를 나타냅니다. search_parameters는 기본값을 포함하여 적용된 설정을 반복합니다. 그 다음에는 organic_results 또는 people_also_ask와 같이 결과 페이지의 각 블록마다 하나의 배열 또는 객체가 옵니다.

블록은 페이지에 표시될 때만 존재하므로 기본값으로 읽어야 합니다. 응답 형식 페이지에서 모든 블록과 필드를 설명합니다.

Google 응답의 형태 (축약된 예시 값)
{
  "search_metadata": { "id": "srch_7f3a9c2e41b8", "status": "success", "engine": "google", "credits_used": 1 },
  "search_parameters": { "engine": "google", "q": "best espresso grinder", "gl": "us", "hl": "en", "page": 1 },
  "search_information": { "total_results": 18600000, "query_displayed": "best espresso grinder" },
  "organic_results": [ { "position": 1, "title": "…", "link": "https://www.example.com/…", "snippet": "…" } ],
  "people_also_ask": [ { "question": "…", "snippet": "…", "link": "https://www.example.org/…" } ],
  "related_searches": [ { "query": "best espresso grinder under 300" } ],
  "pagination": { "current": 1, "next_page": 2 }
}

가장 먼저 사용할 파라미터는 무엇인가요?

기본값과 허용 값이 포함된 전체 목록은 API 레퍼런스에 있습니다.

파라미터예시기능
qbest espresso grinder사람이 입력할 법한 검색 쿼리입니다. 필수입니다.
enginegoogle_news검색할 엔진과 버티컬입니다. 기본값 google.
glde결과의 국가 코드, 두 글자입니다. 기본값 us.
hlde인터페이스 언어입니다. 기본값 en.
locationAustin, Texas, United States로컬 결과를 위한 도시 단위 위치입니다.
devicemobiledesktop (기본값) 또는 mobile 결과입니다.
page2결과 페이지, 1에서 10까지입니다. 각 페이지는 1 크레딧입니다.

검색 비용은 얼마이며 언제 무료인가요?

1 크레딧 = 성공한 검색 요청 1건이며, 지원되는 모든 엔진에서 결과 한 페이지를 반환합니다. 실패한 요청은 과금되지 않습니다. 페이지당 약 10개의 유기적 결과로, Google이 2025년 9월 num=100을 더 이상 지원하지 않게 된 이후 제공되는 방식입니다. 추가 페이지마다 크레딧이 1개 더 차감됩니다. 잘못된 파라미터, 잘못된 키, 빈 잔액 또는 사용 중인 계정으로 인해 거부된 요청도 무료이며, 크레딧 endpoint에 대한 모든 호출도 무료입니다.

가격은 2026년 10월 기준 검색 10,000회의 US$7.50부터 가장 큰 팩의 US$0.30/1K 검색까지입니다. 선불 검색 크레딧은 만료되지 않습니다: 사용하지 않은 검색은 사용할 때까지 계정에 남아 있습니다. 에러 페이지에서 각 에러 코드와 올바른 재시도 방법을 확인할 수 있습니다.

다음으로 어디로 가야 하나요?

빠른 시작 질문

SerpCrypto 공식 SDK가 있나요?

아니요. 문서에는 HTTPS endpoint를 직접 호출하는 Python, Node.js, curl용 복사-붙여넣기 코드가 있어서 설치하거나 최신 상태로 유지할 패키지가 없습니다. HTTP 클라이언트가 있는 언어라면 모두 동일하게 동작합니다: GET 요청 하나, 헤더 하나, JSON 응답 하나.

API 키를 URL에 넣어도 되나요?

네. api_key=YOUR_KEY은 쿼리 파라미터로 동작하며, 브라우저에서 빠르게 테스트할 때 유용합니다. 코드에서는 Authorization: Bearer 헤더를 권장합니다. URL은 헤더보다 로그, 브라우저 기록, 공유 스크린샷에 남는 경우가 더 많기 때문입니다.

KYC나 신용카드가 필요한가요?

아니요. SerpCrypto은 신분증, 셀피, 서류, 카드 모두 요구하지 않습니다. 계정 번호로 로그인하며 이메일은 선택 사항입니다. BTC, USDT, USDC, ETH, SOL, LTC으로 결제하며 최소 충전 금액은 US$25입니다.

큰 팩을 사기 전에 어떻게 테스트하나요?

무료 티어 없음: 최소 충전 금액으로 결제한 가장 작은 팩으로 테스트하세요. 최소 충전 금액에 도달하기 위해서만 추가된 금액은 사용하지 않은 경우 30일 이내에 요청 시 USDT 또는 USDC로 환불됩니다. 가장 작은 팩도 가장 큰 팩과 동일한 endpoint와 엔진에서 동작하므로, 작은 팩으로 테스트하면 실제 운영 환경이 어떤지 알 수 있습니다.

US$0.30/1K 검색부터 · KYC 없이

API 키 발급