เอกสาร · เอกสารอ้างอิง API · เวอร์ชัน 1

เอกสารอ้างอิง SERP API: GET /search และ GET /credits

Q: เกิดอะไรขึ้นเมื่อเครดิตของฉันหมด

การค้นหาครั้งถัดไปจะคืน 402 insufficient_credits และไม่ใช้เครดิตใดๆ ซื้อ pack อีกชุดจากยอดคงเหลือของคุณได้ที่ หน้าราคา; API key ของคุณยังใช้งานได้และการค้นหากลับมาทำงานทันที

ทุกพารามิเตอร์ ค่าเริ่มต้น และรหัสข้อผิดพลาดของ API SerpCrypto เวอร์ชัน 1 Base URL: https://serpcrypto.com/api/v1 ทุกคำขอใช้ HTTPS และทุกคำตอบเป็น JSON ใน UTF-8

อัปเดตล่าสุด: 22 ตุลาคม 2569 · 5 นาทีในการอ่าน

คำตอบสั้น

endpoint ค้นหาของ SerpCrypto รับพารามิเตอร์อะไรบ้าง?

GET https://serpcrypto.com/api/v1/search รับพารามิเตอร์ที่จำเป็นหนึ่งตัวคือ q และพารามิเตอร์เสริมเก้าตัว: engine, gl, hl, location, google_domain, device, page, safe และ period SerpCrypto คืนค่าเป็น JSON และคิด 1 เครดิตต่อการค้นหาที่สำเร็จบนทุก 6 เอนจิน ส่วนข้อผิดพลาดฟรี แพ็กเริ่มต้นที่ US$7.50 สำหรับ 10,000 การค้นหา จ่ายด้วยคริปโต ไม่ต้อง KYC

จะยืนยันตัวตนอย่างไร?

ส่งคีย์ของคุณได้สองวิธี วิธีที่แนะนำคือ header Authorization: Bearer YOUR_KEY อีกวิธีคือ query parameter api_key=YOUR_KEY ซึ่งสะดวกสำหรับทดสอบเร็ว ๆ ในแท็บเบราว์เซอร์

คีย์ที่หายไป ผิด หรือถูกเพิกถอนจะได้ 401 invalid_api_key และไม่มีค่าใช้จ่าย API key ที่คุณสร้างและเพิกถอนได้ทุกเมื่อจากแดชบอร์ดของคุณ ดังนั้นคุณจึงให้แต่ละสคริปต์หรือเซิร์ฟเวอร์มีคีย์ของตัวเอง และเพิกถอนคีย์หนึ่งโดยไม่กระทบคีย์อื่นได้

รันการค้นหา

GET/api/v1/search

รันการค้นหาหนึ่งครั้งบนเอนจินที่เลือกและคืนหน้าผลลัพธ์เป็น JSON การค้นหาที่สำเร็จใช้ 1 เครดิต ไม่ว่าเอนจินใด ส่วนข้อผิดพลาดไม่ใช้เลย พารามิเตอร์ใส่ใน query string แบบ URL-encoded ตัวอย่างค้นหา Google หาโรงคั่วกาแฟใน Austin, Texas ส่วน ID จำนวน และผลลัพธ์เป็นเพียงตัวอย่าง

การยืนยันตัวตน: API key ใน header Authorization: Bearer API_KEY

พารามิเตอร์

ชื่อ	In	Type	Required	คำอธิบาย
`q`	query	string	ใช่	คำค้นหา ตามที่คนพิมพ์จริง ผู้ดำเนินการค้นหา เช่น เครื่องหมายคำพูด หรือ `site:` ถือเป็นส่วนหนึ่งของคำค้นหา
`engine`	query	string	ไม่ใช่	`google` (ค่าเริ่มต้น), `google_news`, `google_images`, `google_maps`, `google_shopping` หรือ `bing`
`gl`	query	string	ไม่ใช่	ประเทศของผลลัพธ์: รหัส ISO 3166-1 alpha-2 ตัวพิมพ์เล็ก เช่น `us`, `de` หรือ `br` ค่าเริ่มต้น `us`
`hl`	query	string	ไม่ใช่	ภาษาของอินเทอร์เฟซ เช่น `en`, `de` หรือ `pt-BR` ค่าเริ่มต้น `en`
`location`	query	string	ไม่ใช่	สถานที่ระดับเมือง เขียนเป็น `City, Region, Country` เช่น `Austin, Texas, United States` ดู สถานที่
`google_domain`	query	string	ไม่ใช่	โดเมน Google ที่จะค้นหา เช่น `google.de` ค่าเริ่มต้น: โดเมนของประเทศ `gl` ถูกเพิกเฉยเมื่อ `engine=bing`
`device`	query	string	ไม่ใช่	`desktop` (ค่าเริ่มต้น) หรือ `mobile`
`page`	query	integer	ไม่ใช่	หน้าผลลัพธ์ตั้งแต่ 1 (ค่าเริ่มต้น) ถึง 10 แต่ละหน้าเป็นการค้นหาแยกกันและใช้ 1 เครดิต
`safe`	query	string	ไม่ใช่	`active` กรองผลลัพธ์ที่ชัดเจนออก; `off` (ค่าเริ่มต้น) ไม่กรอง
`period`	query	string	ไม่ใช่	เฉพาะผลลัพธ์จากชั่วโมงที่แล้ว (`h`), วัน (`d`), สัปดาห์ (`w`), เดือน (`m`) หรือปี (`y`)
`api_key`	query	string	ไม่ใช่	API key ของคุณ หากคุณไม่ส่ง header `Authorization`

Response `200`

{
  "search_metadata": {
    "id": "srch_7f3a9c2e41b8",
    "status": "success",
    "engine": "google",
    "created_at": "2026-10-22T09:14:05Z",
    "credits_used": 1
  },
  "search_parameters": {
    "engine": "google",
    "q": "coffee roasters",
    "gl": "us",
    "hl": "en",
    "location": "Austin, Texas, United States",
    "google_domain": "google.com",
    "device": "desktop",
    "page": 1
  },
  "search_information": {
    "total_results": 18600000,
    "query_displayed": "coffee roasters"
  },
  "local_results": [
    {
      "position": 1,
      "title": "Example Coffee Roasters",
      "address": "123 Example St, Austin, TX",
      "rating": 4.7,
      "reviews": 312,
      "type": "Coffee roasters"
    }
  ],
  "organic_results": [
    {
      "position": 1,
      "title": "The 12 best coffee roasters in Austin",
      "link": "https://www.example.com/austin/coffee-roasters",
      "displayed_link": "www.example.com › austin › coffee",
      "snippet": "From light Nordic roasts to dark espresso blends, these local roasters…",
      "date": "Sep 30, 2026"
    },
    {
      "position": 2,
      "title": "Example Roasting Co. | Fresh beans, roasted in Austin",
      "link": "https://www.example.org/",
      "displayed_link": "www.example.org",
      "snippet": "Small-batch coffee roasted every weekday and shipped the same day…"
    }
  ],
  "people_also_ask": [
    {
      "question": "What is the oldest coffee roaster in Austin?",
      "snippet": "…",
      "title": "Austin coffee history",
      "link": "https://www.example.net/austin-coffee-history"
    }
  ],
  "related_searches": [
    {
      "query": "coffee roasters near me"
    },
    {
      "query": "coffee roasters austin wholesale"
    }
  ],
  "pagination": {
    "current": 1,
    "next_page": 2
  }
}

ตัวอย่างโค้ด

curl

curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=coffee roasters" \
  --data-urlencode "location=Austin, Texas, United States" \
  -d gl=us -d hl=en -d device=desktop

Python

import os

import requests

r = requests.get(
    "https://serpcrypto.com/api/v1/search",
    params={
        "q": "coffee roasters",
        "location": "Austin, Texas, United States",
        "gl": "us",
        "hl": "en",
    },
    headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]},
    timeout=60,
)
r.raise_for_status()
print(r.json()["organic_results"][0]["link"])

Node.js

const params = new URLSearchParams({
  q: "coffee roasters",
  location: "Austin, Texas, United States",
  gl: "us",
  hl: "en",
});
const res = await fetch("https://serpcrypto.com/api/v1/search?" + params, {
  headers: { Authorization: "Bearer " + process.env.SERPCRYPTO_API_KEY },
});
const data = await res.json();
console.log(data.organic_results?.[0]?.link);

มีค่า engine อะไรบ้าง และแต่ละค่าคืนอะไร?

โครงสร้าง (search_metadata, search_parameters, search_information) เหมือนกันทุก engine บล็อกจะปรากฏเฉพาะเมื่อหน้านั้นแสดงมัน

`engine`	แหล่งที่มา	บล็อกหลักในคำตอบ
`google`	ผลการค้นหา Google	`ai_overview`, `organic_results`, `ads`, `people_also_ask`, `local_results`, `knowledge_graph`, `top_stories`, `inline_videos`, `shopping_results`, `related_searches`, `pagination`
`google_news`	Google News	`news_results`: title, link, source, date, snippet, thumbnail
`google_images`	Google Images	`images_results`: URL ต้นฉบับและขนาด, thumbnail, หน้าแหล่งที่มา
`google_maps`	Google Maps	`local_results`: ชื่อ, ที่อยู่, โทรศัพท์, เว็บไซต์, คะแนน, รีวิว, หมวดหมู่, เวลาทำการ, พิกัด
`google_shopping`	Google Shopping	`shopping_results`: title, price, extracted price, currency, merchant, delivery, rating
`bing`	Bing	`organic_results`, `related_searches`

อ่านเครดิตของคุณ

GET/api/v1/credits

คืนค่าเครดิตที่เหลือในบัญชีของคุณ เครดิตที่ใช้ไปตั้งแต่เที่ยงคืน UTC และจำนวนการค้นหาที่บัญชีของคุณรันพร้อมกันได้ การเรียกนี้ฟรี ค่าด้านล่างเป็นตัวอย่าง

การยืนยันตัวตน: API key ใน header Authorization: Bearer API_KEY

Response `200`

{
  "credits_remaining": 84210,
  "credits_used_today": 1290,
  "concurrency_limit": 10
}

ตัวอย่างโค้ด

curl

curl -s "https://serpcrypto.com/api/v1/credits" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY"

Python

import os

import requests

r = requests.get(
    "https://serpcrypto.com/api/v1/credits",
    headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]},
    timeout=30,
)
r.raise_for_status()
print(r.json()["credits_remaining"])

Node.js

const res = await fetch("https://serpcrypto.com/api/v1/credits", {
  headers: { Authorization: "Bearer " + process.env.SERPCRYPTO_API_KEY },
});
const { credits_remaining } = await res.json();
console.log(credits_remaining);

API สามารถคืน error อะไรได้บ้าง?

ทุก error มี body เป็น {"error": {"code": "…", "message": "…"}} หน้า errors อธิบายแต่ละตัวและแสดง retry code

HTTP	`code`	เมื่อเกิดขึ้น	เรียกเก็บ
400	`invalid_parameter`	พารามิเตอร์ที่จำเป็นหายไป หรือค่าอยู่นอกช่วงที่อนุญาต	ไม่ใช่
401	`invalid_api_key`	API key หายไป ผิด หรือถูกเพิกถอน	ไม่ใช่
402	`insufficient_credits`	บัญชีของคุณไม่มีเครดิตเหลือ	ไม่ใช่
429	`concurrency_limit`	มีการค้นหามากเกินไปที่รันพร้อมกันในบัญชีของคุณ	ไม่ใช่
502	`search_failed`	engine หรือการเก็บข้อมูลล้มเหลวสำหรับคำขอนี้ ลองใหม่	ไม่ใช่
504	`search_timeout`	ไม่มีการตอบกลับภายในเวลา ลองใหม่	ไม่ใช่

เรียกเก็บเงินอะไรกันแน่?

การค้นหาที่สำเร็จหนึ่งครั้ง = หนึ่งเครดิต บนทุก engine รวมถึง Google Maps และ Google Shopping
ผลลัพธ์แต่ละหน้าเป็นการค้นหาหนึ่งครั้ง ผลลัพธ์ออร์แกนิกประมาณ 10 รายการต่อหน้า ตามที่ Google ให้บริการตั้งแต่เลิกใช้ num=100 ในเดือนกันยายน 2025; แต่ละหน้าเพิ่มคือหนึ่งเครดิตเพิ่มเติม
error ฟรี: ทุกคำตอบที่มี HTTP status อื่นที่ไม่ใช่ 200 ไม่ใช้เครดิต
การอ่านเครดิตของคุณฟรี

เครดิตการค้นหาแบบเติมเงินไม่มีวันหมดอายุ: คำค้นหาที่ไม่ได้ใช้จะคงอยู่ในบัญชีของคุณจนกว่าคุณจะใช้ แพ็กมีตั้งแต่ US$7.50 สำหรับ 10,000 การค้นหา ไปจนถึง US$0.30/1K การค้นหา ในแพ็กที่ใหญ่ที่สุด ดู ราคา

ฉันควร encode คำค้นหาอย่างไร?

ส่ง q แบบ URL-encoded เหมือนค่า query-string ทั่วไป: ช่องว่างกลายเป็น %20 หรือ + และตัวอักษรที่มีวรรณยุกต์ถูก encode เป็น UTF-8 curl ทำเช่นนี้ด้วย --data-urlencode, Python requests และ httpx ทำด้วย params= ส่วน Node.js ทำด้วย URLSearchParams

เขียนคำค้นหาเหมือนที่คนพิมพ์ในช่องค้นหาจริง ๆ เครื่องหมายคำพูด เครื่องหมายลบ หรือ site: อยู่ใน q ตามเดิม engine เป็นผู้ตัดสินว่าจะใช้มันอย่างไร เช่นเดียวกับที่ทำกับผู้เข้าชม

API มีเวอร์ชันหรือไม่?

มี เวอร์ชันเป็นส่วนหนึ่งของ path: /api/v1/ ฟิลด์หรือบล็อกใหม่อาจปรากฏในคำตอบเวอร์ชัน 1 โค้ดของคุณจึงควรเพิกเฉยต่อคีย์ที่ไม่รู้จัก การลบหรือเปลี่ยนชื่อฟิลด์จะมาพร้อมเวอร์ชันใหม่ใน path ไม่ใช่การเปลี่ยนแปลงใน v1

คำถามเกี่ยวกับ API reference

ส่ง POST request พร้อม JSON body ได้ไหม

ไม่ได้ในเวอร์ชัน 1: ทั้งสอง endpoint รับ GET request โดยส่ง parameter ใน query string ซึ่งทำให้ทุกการเรียกทำซ้ำได้ง่ายด้วย curl หรือเบราว์เซอร์ และบันทึก log ได้ง่ายโดยไม่ต้องมี body

การค้นหาหนึ่งครั้งคืนผลลัพธ์กี่รายการ

ผลลัพธ์ออร์แกนิกประมาณ 10 รายการต่อหน้า ตามที่ Google ให้บริการตั้งแต่เลิกใช้ num=100 ในเดือนกันยายน 2025; แต่ละหน้าเพิ่มคือหนึ่งเครดิตเพิ่มเติม หากต้องการเก็บ 30 ผลลัพธ์ ให้เรียก page=1, page=2 และ page=3: สามครั้งค้นหา สามเครดิต

เกิดอะไรขึ้นเมื่อเครดิตของฉันหมด

การค้นหาครั้งถัดไปจะคืน 402 insufficient_credits และไม่ใช้เครดิตใดๆ ซื้อ pack อีกชุดจากยอดคงเหลือของคุณได้ที่ หน้าราคา; API key ของคุณยังใช้งานได้และการค้นหากลับมาทำงานทันที

ใช้ API key เดียวกันจากหลายเซิร์ฟเวอร์ได้ไหม

ได้ API key ไม่ผูกกับ IP address สิ่งที่จำกัดคือจำนวนการค้นหาที่ทำงานพร้อมกันในบัญชี: concurrency_limit ใน GET /credits ระบุตัวเลขไว้

จะยืนยันตัวตนอย่างไร?

รันการค้นหา

พารามิเตอร์

Response 200

ตัวอย่างโค้ด

มีค่า engine อะไรบ้าง และแต่ละค่าคืนอะไร?

อ่านเครดิตของคุณ

Response 200

ตัวอย่างโค้ด

API สามารถคืน error อะไรได้บ้าง?

เรียกเก็บเงินอะไรกันแน่?

ฉันควร encode คำค้นหาอย่างไร?

API มีเวอร์ชันหรือไม่?

คำถามเกี่ยวกับ API reference

ส่ง POST request พร้อม JSON body ได้ไหม

การค้นหาหนึ่งครั้งคืนผลลัพธ์กี่รายการ

เกิดอะไรขึ้นเมื่อเครดิตของฉันหมด

ใช้ API key เดียวกันจากหลายเซิร์ฟเวอร์ได้ไหม

หน้าที่เกี่ยวข้อง

Response `200`

Response `200`