# SERP API quick start: การค้นหาครั้งแรกของคุณใน curl, Python และ Node.js

> เรียกใช้ SerpCrypto SERP API ครั้งแรกด้วย curl, Python หรือ Node.js: รับ API key, เรียก endpoint, อ่าน JSON, ตรวจเครดิต จ่ายด้วยคริปโต

- URL: https://serpcrypto.com/th/docs/
- อัปเดตล่าสุด: 2026-10-22
- ผู้เผยแพร่: SerpCrypto (https://serpcrypto.com)

หนึ่ง HTTPS endpoint, หนึ่ง API key, หนึ่งเครดิตต่อการค้นหาที่สำเร็จ หน้านี้พาคุณจากบัญชีเปล่าไปสู่หน้าผลการค้นหา Google ที่ parse แล้ว จากนั้นชี้ไปที่ reference สำหรับส่วนที่เหลือ

**คำตอบสั้น — ฉันจะส่ง SERP API request ครั้งแรกด้วย SerpCrypto ได้อย่างไร**

ซื้อ credit pack คัดลอก API key จาก dashboard แล้วส่ง `GET https://serpcrypto.com/api/v1/search?q=your+query` พร้อม header `Authorization: Bearer YOUR_KEY` **SerpCrypto** ตอบกลับด้วยหน้าผลลัพธ์เป็น JSON และหัก 1 เครดิตเฉพาะเมื่อการค้นหาสำเร็จ 10,000 การค้นหา ราคา US$7.50 จ่ายด้วยคริปโต ไม่ต้อง KYC และเครดิตไม่มีวันหมดอายุ

## API โดยสรุป

| คุณลักษณะ | ค่า |
| --- | --- |
| Base URL | `https://serpcrypto.com/api/v1` |
| การค้นหา | `GET https://serpcrypto.com/api/v1/search` |
| เครดิต | `GET https://serpcrypto.com/api/v1/credits` (ฟรี) |
| การยืนยันตัวตน | API key ใน header Authorization (Bearer) หรือใน query parameter api_key |
| เอนจิน | Google Search, Google News, Google Images, Google Maps (ผลลัพธ์ท้องถิ่น), Google Shopping และ Bing |
| การเรียกเก็บเงิน | 1 เครดิต = 1 คำขอค้นหาที่สำเร็จ ซึ่งคืนผลลัพธ์หนึ่งหน้าบนเอนจินที่รองรับ คำขอที่ล้มเหลวจะไม่ถูกคิดเครดิต |
| อายุเครดิต | เครดิตการค้นหาแบบเติมเงินไม่มีวันหมดอายุ: คำค้นหาที่ไม่ได้ใช้จะคงอยู่ในบัญชีของคุณจนกว่าคุณจะใช้ |
| รูปแบบ | JSON ผ่าน HTTPS, UTF-8 |

## ฉันจะรับ API key ได้อย่างไร

สี่ขั้นตอน ไม่ต้องใช้บัตรประชาชน ไม่ต้องเซลฟี่ ไม่ต้องใช้เอกสาร และไม่ต้องใช้อีเมล เว้นแต่คุณต้องการ

1. **เปิดบัญชี** — เข้าสู่ระบบด้วยหมายเลขบัญชี; อีเมลไม่บังคับ เก็บหมายเลขบัญชีไว้ใน password manager: มันคือข้อมูลเข้าสู่ระบบของคุณ
2. **เติมเงินด้วยคริปโต** — ส่งอย่างน้อย US$25 ใน BTC, USDT, USDC, ETH, SOL, LTC ยอดคงเหลือจะถูกเติมหลังจากการยืนยันบน network ตามที่ระบุไว้ใน หน้าชำระเงิน
3. **ซื้อ credit pack** — 10,000 การค้นหา สำหรับ US$7.50 เพียงพอที่จะทดสอบทุก engine pack ที่ใหญ่กว่าจะลดอัตราลงเหลือ US$0.30/1K การค้นหา ดู ราคา
4. **คัดลอก API key ของคุณ** — API key ของคุณจะปรากฏในแดชบอร์ดทันทีที่คุณซื้อแพ็กเกจเครดิตจากยอดคงเหลือคริปโตที่ยืนยันแล้ว เก็บไว้ใน environment variable ชื่อ SERPCRYPTO_API_KEY ห้ามเก็บใน code repository

## ฉันจะรันการค้นหาครั้งแรกด้วย curl ได้อย่างไร

export API key หนึ่งครั้ง จากนั้นส่งหนึ่ง GET request แฟล็ก `-G` พร้อมกับ `--data-urlencode` จะสร้าง query string และเข้ารหัสช่องว่างและตัวอักษรที่มีวรรณยุกต์ให้คุณ คำตอบคือเอกสาร JSON เดียว และ `jq` ช่วยให้อ่านได้ง่ายใน terminal

ตัวอย่างถาม Google ซึ่งเป็น engine เริ่มต้น ขอผลลัพธ์สหรัฐฯ เป็นภาษาอังกฤษ เปลี่ยน `q`, `gl` หรือ `hl` แล้วรันอีกครั้ง: ทุกครั้งที่สำเร็จจะใช้หนึ่งเครดิต

*curl + jq: สามผลลัพธ์ organic แรก*

```bash
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 client ใดก็ได้ ด้วย `requests` ส่ง parameter เป็น dictionary และ API key ใน header `raise_for_status()` จะเปลี่ยนคำตอบที่เป็น error เช่น `401` สำหรับ API key ที่ผิด ให้กลายเป็น exception ที่คุณดักจับได้

*Python 3.9+ พร้อม requests*

```python
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` มาพร้อมแล้ว จึงไม่ต้องติดตั้ง package เพิ่ม บันทึกไฟล์ด้วยนามสกุล `.mjs` เพื่อใช้ `await` ที่ระดับบนสุด จากนั้นรัน `node first-search.mjs`

*Node.js 18+ พร้อม fetch ในตัว*

```javascript
// 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` ด้วย API key เดียวกัน ไม่มีค่าใช้จ่ายและคืนค่าตัวเลขสามตัว: เครดิตที่เหลือ เครดิตที่ใช้ไปวันนี้ และจำนวนการค้นหาที่บัญชีของคุณรันพร้อมกันได้ แต่ละบัญชีสามารถรันการค้นหาได้ตามจำนวนที่กำหนดในเวลาเดียวกัน; ขีดจำกัดแสดงอยู่ในแดชบอร์ดของคุณและเพิ่มได้เมื่อร้องขอ

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

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

*คำตอบ (ค่าตัวอย่าง)*

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

## ผลลัพธ์จากการค้นหาคืออะไร?

ทุกคำตอบมีโครงสร้างเดียวกันในทุกเอนจิน `search_metadata` บอกว่าการค้นหาสำเร็จหรือไม่และใช้เครดิตไปเท่าไร `search_parameters` แสดงการตั้งค่าที่ใช้จริงรวมถึงค่าเริ่มต้น จากนั้นจะมีอาร์เรย์หรือออบเจ็กต์ต่อบล็อกของหน้าผลลัพธ์ เช่น `organic_results` หรือ `people_also_ask`

บล็อกจะปรากฏเฉพาะเมื่อหน้านั้นแสดงผล ดังนั้นให้อ่านด้วยค่าเริ่มต้น หน้า [รูปแบบการตอบกลับ](https://serpcrypto.com/th/docs/response/) อธิบายทุกบล็อกและฟิลด์

*โครงสร้างคำตอบ Google (ย่อ, ค่าตัวอย่างเพื่อประกอบ)*

```json
{
  "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 reference](https://serpcrypto.com/th/docs/search/)

| พารามิเตอร์ | ตัวอย่าง | สิ่งที่มันทำ |
| --- | --- | --- |
| `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 คำขอค้นหาที่สำเร็จ ซึ่งคืนผลลัพธ์หนึ่งหน้าบนเอนจินที่รองรับ คำขอที่ล้มเหลวจะไม่ถูกคิดเครดิต ผลลัพธ์ออร์แกนิกประมาณ 10 รายการต่อหน้า ตามที่ Google ให้บริการตั้งแต่เลิกใช้ num=100 ในเดือนกันยายน 2025; แต่ละหน้าเพิ่มคือหนึ่งเครดิตเพิ่มเติม คำขอที่ถูกปฏิเสธเนื่องจากพารามิเตอร์ผิด API key ผิด ยอดคงเหลือเป็นศูนย์ หรือบัญชีไม่ว่างก็ฟรีเช่นกัน และการเรียกไปยัง endpoint เครดิตทุกครั้งก็ฟรี

ราคาเริ่มตั้งแต่ US$7.50 สำหรับ 10,000 การค้นหา ถึง US$0.30/1K การค้นหา ในแพ็กที่ใหญ่ที่สุด ณ ตุลาคม 2026 เครดิตการค้นหาแบบเติมเงินไม่มีวันหมดอายุ: คำค้นหาที่ไม่ได้ใช้จะคงอยู่ในบัญชีของคุณจนกว่าคุณจะใช้ หน้า [ข้อผิดพลาด](https://serpcrypto.com/th/docs/errors/) แสดงรายการรหัสข้อผิดพลาดแต่ละรายการและวิธีลองใหม่ที่ถูกต้อง

## ฉันจะไปที่ไหนต่อ?

- [API reference: GET /search](https://serpcrypto.com/th/docs/search/) — ทุกพารามิเตอร์ ค่าเริ่มต้น และข้อผิดพลาด
- [รูปแบบการตอบกลับ](https://serpcrypto.com/th/docs/response/) — แต่ละบล็อกและฟิลด์ของ JSON
- [ตำแหน่งและภาษา](https://serpcrypto.com/th/docs/locations/) — gl, hl, location, device
- [ข้อผิดพลาดและการลองใหม่](https://serpcrypto.com/th/docs/errors/) — รหัส สาเหตุ การ backoff
- [Python](https://serpcrypto.com/th/docs/python/) — คำขอ, httpx async, การส่งออก CSV
- [Node.js](https://serpcrypto.com/th/docs/node/) — fetch, พูล concurrency, การแบ่งหน้า
- [curl และ jq](https://serpcrypto.com/th/docs/curl/) — สูตรแบบบรรทัดเดียว
- [MCP server](https://serpcrypto.com/th/docs/mcp/) — การค้นหาเว็บใน Claude Desktop และ Cursor
- [LangChain และ LlamaIndex](https://serpcrypto.com/th/docs/langchain/) — เครื่องมือค้นหาสำหรับเอเจนต์
- [OpenAI function calling](https://serpcrypto.com/th/docs/openai/) — สคีมาของเครื่องมือและลูปการเรียก

## คำถามเริ่มต้นอย่างรวดเร็ว

### มี SDK อย่างเป็นทางการของ SerpCrypto หรือไม่?

ไม่ต้อง นักพัฒนาได้เตรียมโค้ดที่คัดลอกไปใช้ได้ทันทีสำหรับ Python, Node.js และ curl ซึ่งเรียก HTTPS endpoint โดยตรง จึงไม่มีแพ็กเกจให้ติดตั้งหรือต้องคอยอัปเดต ภาษาใดก็ตามที่มี HTTP client ก็ทำงานแบบเดียวกัน คือส่ง GET request หนึ่งครั้ง ใส่ header หนึ่งรายการ แล้วได้คำตอบเป็น JSON หนึ่งชุด

### ใส่ API key ไว้ใน URL ได้ไหม

ได้ `api_key=YOUR_KEY` ใช้เป็น query parameter ได้ ซึ่งช่วยเวลาทดสอบเร็วๆ ในเบราว์เซอร์ ในโค้ดควรใช้ header `Authorization: Bearer` ดีกว่า เพราะ URL มักไปโผล่ใน log ประวัติเบราว์เซอร์ และภาพหน้าจอที่แชร์กันบ่อยกว่า header

### ต้องทำ KYC หรือใช้บัตรเครดิตไหม

ไม่ต้อง SerpCrypto ไม่ต้องใช้บัตรประชาชน ไม่ต้องเซลฟี่ ไม่ต้องส่งเอกสาร และไม่ต้องใช้บัตร เข้าสู่ระบบด้วยหมายเลขบัญชี; อีเมลไม่บังคับ คุณจ่ายด้วย BTC, USDT, USDC, ETH, SOL, LTC โดยเติมขั้นต่ำ US$25

### ทดสอบก่อนซื้อแพ็กใหญ่ได้อย่างไร

ไม่มีระดับฟรี: ทดสอบด้วยแพ็กเกจที่เล็กที่สุด โดยชำระจากยอดเติมขั้นต่ำ; ส่วนที่เพิ่มเพื่อให้ถึงขั้นต่ำเท่านั้นสามารถขอคืนได้ภายใน 30 วัน เป็น USDT หรือ USDC หากยังไม่ได้ใช้ แพ็กเล็กสุดใช้ endpoint และเอนจินเดียวกับแพ็กใหญ่สุด ดังนั้นการทดสอบด้วยแพ็กเล็กจะบอกคุณได้ว่างานจริงจะเป็นอย่างไร

---

SerpCrypto: SerpCrypto คือ SERP API สำหรับนักพัฒนาและ AI agent ที่ส่งคืนผลการค้นหา Google และ Bing เป็น JSON จ่ายด้วยคริปโตโดยไม่ต้องอัปโหลดบัตรประชาชน เครดิตการค้นหาแบบเติมเงินจาก US$0.30/1K การค้นหา ไม่มีวันหมดอายุ ไม่ต้อง KYC — ไม่ต้องใช้บัตรประชาชน ไม่ต้องเซลฟี่ ไม่ต้องใช้เอกสาร จ่ายด้วยคริปโต