DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ChatGPT LLM Scraper trực tiếp
Hỏi ChatGPT một keyword như người dùng và trả về câu trả lời đã phân tích. Trả về keyword, location_code, language_code, model, datetime, markdown, sources, fan_out_queries và brand_entities - markdown là câu trả lời như trợ lý đã hiển thị, sources là các trang được trích dẫn, và brand_entities là các thương hiệu được nêu tên. force_web_search khiến mô hình duyệt web thay vì trả lời từ dữ liệu huấn luyện. Được bọc trong phong bì của DataForSEO: dữ liệu ở tasks[0].result, kết quả ở tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Đây là endpoint cho câu hỏi 'ChatGPT nói gì về chúng ta'; để đếm lượt nhắc đến trên nhiều câu trả lời, dùng post_dataforseo_ai_llm_mentions_aggregated_metrics_live thay vì thu thập lặp lại. Dạng thô là post_dataforseo_ai_chat_gpt_llm_scraper_live_html.
Tham chiếu giá
- Đo lường: Chi phí phản hồi được báo cáo.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.004.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: array (object | null)[]
- forceKiểu: boolean | null
_web _search buộc tác nhân AI dùng tìm kiếm web
trường tùy chọn
khi bật, mô hình AI bị buộc truy cập và trích dẫn thông tin web hiện tại;
giá trị mặc định:false;
Lưu ý: ngay cả khi tham số được đặt thànhtrue, không có gì bảo đảm các nguồn web sẽ được trích dẫn trong phản hồi - keywordKiểu: string
từ khóa
trường bắt buộc
bạn có thể chỉ định tối đa 2000 ký tự trong trườngkeyword
mọi %## sẽ được giải mã (ký tự ‘+’ cũng sẽ được giải mã thành ký tự dấu cách)
nếu bạn cần dùng ký tự “%” chokeyword, hãy chỉ định nó là “%25”;
nếu bạn cần dùng ký tự “+” chokeyword, hãy chỉ định nó là “%2B”tìm hiểu thêm về quy tắc và giới hạn của các trường
keywordvàkeywordstrong API DataForSEO tại bài viết Trung tâm trợ giúp này - languageKiểu: string
_code mã ngôn ngữ của công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlanguage_name;
nếu bạn dùng trường này, bạn không cần chỉ địnhlanguage_name;
bạn có thể nhận danh sách ngôn ngữ khả dụng của công cụ tìm kiếm cùnglanguage_codecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages - languageKiểu: string
_name tên đầy đủ của ngôn ngữ công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlanguage_code;
nếu bạn dùng trường này, bạn không cần chỉ địnhlanguage_code;
bạn có thể nhận danh sách ngôn ngữ khả dụng của công cụ tìm kiếm cùnglanguage_namecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages - locationKiểu: integer
_code mã vị trí của công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlocation_name
nếu bạn dùng trường này, bạn không cần chỉ địnhlocation_name
bạn có thể nhận danh sách vị trí khả dụng của công cụ tìm kiếm cùnglocation_codecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
ví dụ:2840 - locationKiểu: string
_name tên đầy đủ của vị trí công cụ tìm kiếm
trường bắt buộc nếu bạn không chỉ địnhlocation_code
nếu bạn dùng trường này, bạn không cần chỉ địnhlocation_code
bạn có thể nhận danh sách vị trí khả dụng của công cụ tìm kiếm cùnglocation_namecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations
ví dụ:United States - tagKiểu: string | null
mã định danh tác vụ do người dùng xác định
trường tùy chọn
giới hạn ký tự là 255
bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả
bạn sẽ thấy giá trịtagđã chỉ định trong đối tượngdatacủa phản hồi
- Kiểu: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo200
- Kiểu: number | null Định dạng: doublecost
tổng chi phí tác vụ, USD
- Kiểu: integer | nullstatus
_code mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- Kiểu: string | nullstatus
_message thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- Kiểu: array (object | null)[] | nulltasks
mảng tác vụ
- Kiểu: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
- costKiểu: number | null Định dạng: double
tổng chi phí tác vụ, USD
- dataKiểu: object | null
chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST
- propertyKiểu: object | null
Name
- idKiểu: string | null
mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID
- pathKiểu: array (string | null)[] | null
Đường dẫn URL
- resultKiểu: array (object | null)[] | null
mảng kết quả
- brandKiểu: array (object | null)[] | null
_entities mảng thực thể thương hiệu
chứa thông tin về các thương hiệu được đề cập trong phản hồi- categoryKiểu: string | null
danh mục của thương hiệu
- markdownKiểu: string | null
- titleKiểu: string | null
tên thương hiệu
- typeKiểu: string | null
loại phần tử
- urlsKiểu: object | null
mảng URL và tên miền liên quan đến thương hiệu
- checkKiểu: string | null
_url URL trực tiếp đến kết quả công cụ tìm kiếm
bạn có thể dùng URL này để đảm bảo chúng tôi đã cung cấp kết quả chính xác - datetimeKiểu: string | null
ngày và giờ nhận được kết quả
theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2019-11-15 12:57:46 +00:00 - fanKiểu: array (string | null)[] | null
_out _queries mảng truy vấn fan-out
chứa các truy vấn tìm kiếm liên quan được dẫn xuất từ truy vấn chính để cung cấp phản hồi toàn diện hơn - itemKiểu: array (string | null)[] | null
_types các loại kết quả tìm kiếm
chứa các loại kết quả tìm kiếm (items) được tìm thấy trong SERP.
các loại mục khả dụng:chat_gpt_text,chat_gpt_table,chat_gpt_navigation_list,chat_gpt_images,chat_gpt_local_businesses,chat_gpt_products - itemsKiểu: array (object | null)[] | null
các phần tử của kết quả ChatGPT
- rankKiểu: integer | null
_absolute thứ hạng tuyệt đối trong SERP
vị trí tuyệt đối trong tất cả phần tử - rankKiểu: integer | null
_group thứ hạng nhóm trong SERP
vị trí trong một nhóm các phần tử có cùng giá trịtype
vị trí của các phần tử có giá trịtypekhác bị bỏ qua khỏirank_group - typeKiểu: string | null
loại phần tử
- itemsKiểu: integer | null Định dạng: int64
_count số kết quả được trả về trong mảng
items - keywordKiểu: string | null
từ khóa nhận được trong mảng POST
từ khóa được trả về với %## đã giải mã (ký hiệu cộng '+' sẽ được giải mã thành dấu cách) - languageKiểu: string | null
_code mã ngôn ngữ trong mảng POST
- locationKiểu: integer | null
_code mã vị trí trong mảng POST
- markdownKiểu: string | null
- modelKiểu: string | null
cho biết phiên bản mô hình
- seKiểu: integer | null Định dạng: int64
_results _count tổng số kết quả
- searchKiểu: array (object | null)[] | null
_results mảng kết quả tìm kiếm
tất cả đầu ra tìm kiếm web mà mô hình truy xuất khi tra cứu thông tin, bao gồm cả bản trùng lặp và mục không được dùng- breadcrumbKiểu: string | null
đường dẫn breadcrumb
- descriptionKiểu: string | null
mô tả kết quả
- domainKiểu: string | null
tên miền kết quả
- titleKiểu: string | null
tiêu đề kết quả
- typeKiểu: string | null
loại phần tử
- urlKiểu: string | null
URL kết quả
- sourcesKiểu: array (object | null)[] | null
mảng nguồn
các nguồn mà mô hình thực sự đã trích dẫn hoặc dựa vào trong câu trả lời cuối cùng- domainKiểu: string | null
tên miền nguồn trong SERP
- markdownKiểu: string | null
- publicationKiểu: string | null
_date ngày và giờ kết quả được xuất bản
ở định dạng: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
ví dụ:2019-11-15 12:57:46 +00:00 - snippetKiểu: string | null
mô tả nguồn
- sourceKiểu: string | null
_name tên nguồn
- thumbnailKiểu: string | null
hình thu nhỏ của nguồn
- titleKiểu: string | null
tiêu đề nguồn
- typeKiểu: string | null
loại phần tử
- urlKiểu: string | null
URL nguồn
- resultKiểu: integer | null Định dạng: int64
_count số phần tử trong mảng kết quả
- statusKiểu: integer | null
_code mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- statusKiểu: string | null
_message thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- timeKiểu: string | null
thời gian thực thi, giây
- Kiểu: integer | null Định dạng: int64tasks
_count số lượng tác vụ trong mảng tasks
- Kiểu: integer | null Định dạng: int64tasks
_error số lượng tác vụ trong mảng tasks được trả về kèm lỗi
- Kiểu: string | nulltime
tổng thời gian thực thi, giây
- Kiểu: string | nullversion
phiên bản hiện tại của API
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"location_code": null,
"language_code": null,
"model": null,
"check_url": null,
"datetime": null,
"markdown": null,
"search_results": [
{
"type": null,
"url": null,
"domain": null,
"title": null,
"description": null,
"breadcrumb": null
}
],
"sources": [
{
"type": null,
"title": null,
"snippet": null,
"domain": null,
"url": null,
"thumbnail": null,
"source_name": null,
"publication_date": null,
"markdown": null
}
],
"fan_out_queries": [
null
],
"brand_entities": [
{
"type": null,
"title": null,
"category": null,
"markdown": null,
"urls": null
}
],
"se_results_count": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null
}
]
}
]
}
]
}