Search

API SERP để truy vấn công cụ tìm kiếm và nhận kết quả có cấu trúc.

Giới thiệu

API Search của AnyCrawl cho phép truy cập có lập trình kết quả từ nhiều công cụ tìm kiếm. Xây dựng cho LLM, trả dữ liệu sạch, có cấu trúc, tối ưu cho xử lý và phân tích AI.

API trả dữ liệu ngay và đồng bộ — không cần polling hay webhook. Hỗ trợ nhiều công cụ tìm kiếm và lấy nhiều trang kết quả trong một request để thu thập dữ liệu đầy đủ.

Tính năng cốt lõi

Đa engine: Hiện hỗ trợ Google, dự kiến thêm engine khác
Tối ưu LLM: JSON có cấu trúc, phù hợp xử lý AI
Đa ngôn ngữ: Tìm theo ngôn ngữ và khu vực khác nhau
Nhiều trang kết quả: Lấy nhiều trang kết quả trong một request
Hiệu năng cao: Đồng thời cao gốc với xử lý bất đồng bộ
Phản hồi tức thì: API đồng bộ — nhận kết quả ngay không cần polling
Kết quả đầy đủ: Trả cả kết quả tìm kiếm và gợi ý

Endpoint API

POST https://api.anycrawl.dev/v1/search

Ví dụ sử dụng

Tìm kiếm cơ bản (Google mặc định)

curl -X POST "https://api.anycrawl.dev/v1/search" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type": "application/json" \
  -d '{
    "query": "OpenAI ChatGPT"
  }'

Tìm kiếm nhiều trang

curl -X POST "https://api.anycrawl.dev/v1/search" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type": "application/json" \
  -d '{
    "query": "machine learning tutorials",
    "pages": 3,
    "limit": 10
  }'

Tìm kiếm theo ngôn ngữ/khu vực

curl -X POST "https://api.anycrawl.dev/v1/search" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type": "application/json" \
  -d '{
    "query": "AnyCrawl",
    "lang": "zh",
    "pages": 2
  }'

Phân trang tìm kiếm

curl -X POST "https://api.anycrawl.dev/v1/search" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type": "application/json" \
  -d '{
    "query": "web scraping tools",
    "offset": 20,
    "limit": 10
  }'

Tìm kiếm an toàn (Safe Search)

curl -X POST "https://api.anycrawl.dev/v1/search" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type": "application/json" \
  -d '{
    "query": "educational content",
    "safe_search": 0
  }'

Tham số request

Parameter	Type	Required	Default	Description
`query`	string	Yes	-	Chuỗi truy vấn tìm kiếm cần thực thi
`template_id`	string	No	-	`template_id` cho lần tìm kiếm này
`variables`	object	No	-	Biến template (chỉ khi có `template_id`)
`engine`	enum	No	`google`	Công cụ tìm kiếm. Hiện hỗ trợ: `google`
`limit`	number	No	10	Số kết quả tối đa mỗi trang
`offset`	number	No	0	Số kết quả bỏ qua (phân trang)
`pages`	number	No	1	Số trang kết quả tìm kiếm (tối thiểu: 1, tối đa: 20)
`lang`	string	No	`en`	Locale ngôn ngữ cho kết quả (ví dụ 'en', 'zh', 'es', 'fr')
`country`	string	No	-	Locale quốc gia cho kết quả (ví dụ 'US', 'GB', 'CN')
`timeRange`	enum	No	-	Lọc khoảng thời gian: `day`, `week`, `month`, `year`
`sources`	enum	No	-	Nguồn tìm: `web`, `images`, `news` (SearXNG)
`safe_search`	number \| null	No	null	Mức tìm kiếm an toàn Google: `0` (tắt), `1` (vừa), `2` (chặt), hoặc null (mặc định). Chỉ áp dụng Google.

Tùy chọn: `scrape_options` cho URL kết quả

Khi có, mỗi URL kết quả có thể được scrape với các tùy chọn đó (cùng trường /v1/scrape, trừ url top-level). Lưu ý: tùy chọn chỉ trình duyệt bị bỏ qua khi scrape không dùng trình duyệt.

Field	Type	Default	Notes
`engine`	enum	-	Engine scrape cho URL kết quả: `auto`, `cheerio`, `playwright`, `puppeteer`
`formats`	array of enum	`["markdown"]`	Định dạng đầu ra: `markdown`, `html`, `text`, `screenshot`, `screenshot@fullPage`, `rawHtml`, `json`, `summary`, `links`
`timeout`	number	`60000`	Timeout mỗi request (ms)
`wait_for`	number	-	Trễ trước khi trích (ms); chỉ engine trình duyệt; thấp hơn `wait_for_selector`
`wait_until`	enum	-	Điều kiện chờ điều hướng: `load`, `domcontentloaded`, `networkidle`, `commit`
`wait_for_selector`	string, object, or array	-	Chờ selector (chỉ engine trình duyệt). Chuỗi CSS, object `{ selector: string, state?: "attached" \| "visible" \| "hidden" \| "detached", timeout?: number }`, hoặc mảng. Mỗi mục chờ lần lượt. Ưu tiên hơn `wait_for`.
`include_tags`	array of string	-	Chỉ gồm phần tử khớp CSS selector
`exclude_tags`	array of string	-	Loại phần tử khớp CSS selector
`only_main_content`	boolean	`true`	Chỉ trích nội dung chính (`include_tags` ưu tiên hơn)
`proxy`	string (URI)	-	URL proxy tùy chọn
`json_options`	object	-	Trích JSON có cấu trúc (schema, user_prompt, schema_name, schema_description)
`extract_source`	enum	`markdown`	Nguồn trích JSON: `markdown` (mặc định) hoặc `html`
`ocr_options`	boolean	`false`	OCR cho ảnh markdown. Ảnh hưởng markdown, không `html`/`rawHtml`.
`max_age`	number	-	Tuổi cache tối đa (ms). `0` bỏ đọc cache; bỏ trống: mặc định máy chủ
`store_in_cache`	boolean	`true`	Có ghi Page Cache cho mỗi lần scrape kết quả hay không

Mục lục