빠른 답변
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 한눈에 보기
| 기본 URL | https://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 키는 어떻게 받나요?
네 단계입니다. 신분증도, 셀카도, 서류도 필요 없고, 원하지 않으면 이메일도 필요 없습니다.
계정 만들기
계정 번호로 로그인하며 이메일은 선택 사항입니다. 계정 번호를 비밀번호 관리자에 저장하세요. 이 번호가 로그인 정보입니다.
암호화폐로 충전하기
BTC, USDT, USDC, ETH, SOL, LTC로 최소 US$25을 보내세요. 잔액은 결제 페이지에 안내된 네트워크 확인 수를 거친 뒤 충전됩니다.
크레딧 팩 구매하기
US$7.50에 검색 10,000회이면 모든 엔진을 테스트하기에 충분합니다. 더 큰 팩은 요금을 US$0.30/1K 검색까지 낮춥니다. 가격을 참고하세요.
키 복사하기
확인된 암호화폐 잔액으로 크레딧 팩을 구매하면 API 키가 즉시 대시보드에 표시됩니다.
SERPCRYPTO_API_KEY라는 이름의 환경 변수에 보관하고, 코드 저장소에는 절대 두지 마세요.
curl로 첫 검색을 어떻게 실행하나요?
키를 한 번 export한 뒤 GET 요청 하나를 보내세요. --data-urlencode과 함께 쓰는 -G 플래그는 쿼리 문자열을 만들고 공백과 악센트를 대신 인코딩해 줍니다. 응답은 JSON 문서 하나이며, jq를 쓰면 터미널에서 읽기 좋게 유지됩니다.
이 예제는 기본 엔진인 Google에 영어로 미국 결과를 요청합니다. q, gl 또는 hl를 바꿔 다시 실행해 보세요. 성공한 실행마다 크레딧 하나를 사용합니다.
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 같은 오류 응답을 잡을 수 있는 예외로 바꿔 줍니다.
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을 실행하세요.
// 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와 같이 결과 페이지의 각 블록마다 하나의 배열 또는 객체가 옵니다.
블록은 페이지에 표시될 때만 존재하므로 기본값으로 읽어야 합니다. 응답 형식 페이지에서 모든 블록과 필드를 설명합니다.
{
"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 레퍼런스에 있습니다.
| 파라미터 | 예시 | 기능 |
|---|---|---|
q | best espresso grinder | 사람이 입력할 법한 검색 쿼리입니다. 필수입니다. |
engine | google_news | 검색할 엔진과 버티컬입니다. 기본값 google. |
gl | de | 결과의 국가 코드, 두 글자입니다. 기본값 us. |
hl | de | 인터페이스 언어입니다. 기본값 en. |
location | Austin, Texas, United States | 로컬 결과를 위한 도시 단위 위치입니다. |
device | mobile | desktop (기본값) 또는 mobile 결과입니다. |
page | 2 | 결과 페이지, 1에서 10까지입니다. 각 페이지는 1 크레딧입니다. |
검색 비용은 얼마이며 언제 무료인가요?
1 크레딧 = 성공한 검색 요청 1건이며, 지원되는 모든 엔진에서 결과 한 페이지를 반환합니다. 실패한 요청은 과금되지 않습니다. 페이지당 약 10개의 유기적 결과로, Google이 2025년 9월 num=100을 더 이상 지원하지 않게 된 이후 제공되는 방식입니다. 추가 페이지마다 크레딧이 1개 더 차감됩니다. 잘못된 파라미터, 잘못된 키, 빈 잔액 또는 사용 중인 계정으로 인해 거부된 요청도 무료이며, 크레딧 endpoint에 대한 모든 호출도 무료입니다.
가격은 2026년 10월 기준 검색 10,000회의 US$7.50부터 가장 큰 팩의 US$0.30/1K 검색까지입니다. 선불 검색 크레딧은 만료되지 않습니다: 사용하지 않은 검색은 사용할 때까지 계정에 남아 있습니다. 에러 페이지에서 각 에러 코드와 올바른 재시도 방법을 확인할 수 있습니다.
다음으로 어디로 가야 하나요?
- API 레퍼런스: GET /search 모든 파라미터, 기본값 및 에러
- 응답 형식 JSON의 각 블록과 필드
- 위치 및 언어 gl, hl, location, device
- 오류 및 재시도 코드, 원인, 백오프
- Python requests, httpx async, CSV 내보내기
- Node.js fetch, 동시성 풀, 페이지네이션
- curl과 jq 한 줄 레시피
- MCP 서버 Claude Desktop 및 Cursor에서의 웹 검색
- LangChain 및 LlamaIndex 에이전트용 검색 도구
- OpenAI 함수 호출 도구 스키마와 호출 루프
빠른 시작 질문
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와 엔진에서 동작하므로, 작은 팩으로 테스트하면 실제 운영 환경이 어떤지 알 수 있습니다.