ChatGPT Scraper
Sử dụng actor scraper.chatgpt để thu thập câu trả lời từ ChatGPT—bao gồm phản hồi Markdown, liên kết tìm kiếm và dữ liệu nguồn—mà không cần phải tự mình phân tích ngược giao diện người dùng.
Request Example
curl 'https://api.scrapeless.com/api/v2/scraper/request' \
--header 'Content-Type: application/json' \
--header 'x-api-token: {you_api_key}' \
--data '{
"actor": "scraper.chatgpt",
"input": {
"prompt": "Most reliable proxy service for data extraction",
"country": "JP",
"web_search": true,
"shopping": true
},
"webhook": {
"url": "http://www.youwebhook.com"
}
}'Body Parameters
| Tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
prompt | string | Có | Prompt gửi đến ChatGPT. |
country | string | Có | Mã quốc gia hoặc khu vực. |
web_search | boolean | Không | Có bật tìm kiếm web hay không. |
shopping | boolean | Không | Có lấy dữ liệu mua sắm hay không. Mặc định là true. Khi được bật, sẽ trả về thông tin sản phẩm trong trường products. |
Response Fields
Lưu ý: Nếu phản hồi bao gồm dữ liệu mua sắm (trường
products), lệnh gọi API sẽ bị tính phí gấp 2 lần mức cơ bản. Điều này là do chi phí tài nguyên bổ sung cần thiết để trích xuất và xử lý thông tin sản phẩm từ nhiều nguồn.
| Tham số | Kiểu dữ liệu | Mô tả |
|---|---|---|
prompt | string | Prompt gốc. |
result_text | string | Phản hồi Markdown từ ChatGPT. |
model | string | Định danh mô hình, ví dụ: gpt-5-1. |
web_search | bool | Cho biết quá trình làm giàu dữ liệu tìm kiếm có được chạy hay không. |
links | array | Mảng các liên kết bổ sung. |
search_result | array | Kết quả SERP liên quan đến phản hồi. |
search_result.attribution | string | Nguồn của kết quả tìm kiếm. |
search_result.snippet | string | Đoạn trích do ChatGPT cung cấp. |
search_result.title | string | Tiêu đề của kết quả tìm kiếm. |
search_result.url | string | URL của kết quả tìm kiếm. |
content_references | array | Các tài liệu tham khảo được bao gồm trong câu trả lời của ChatGPT. |
content_references.attribution | string | Nguồn của tài liệu tham khảo. |
content_references.title | string | Tiêu đề của nội dung được tham chiếu. |
content_references.url | string | URL của nội dung được tham chiếu. |
products | array | Thông tin sản phẩm do ChatGPT trả về. |
products.id | string | Định danh sản phẩm duy nhất. |
products.title | string | Tiêu đề sản phẩm. |
products.description | string | Mô tả sản phẩm (có thể là null). |
products.price | string | Giá hiển thị, ví dụ: $799.99. |
products.rating | float | Điểm đánh giá trung bình. |
products.num_reviews | int | Số lượng đánh giá. |
products.merchants | string | Tên nhà bán lẻ, ví dụ: Sony + others. |
products.image_urls | array | Mảng các URL hình ảnh sản phẩm. |
products.url | string | URL trang sản phẩm. |
products.offers | array | Mảng các ưu đãi mua hàng. |
products.offers.merchant_name | string | Tên nhà bán lẻ. |
products.offers.price | string | Giá ưu đãi. |
products.offers.price_details | object | Chi tiết phân tích giá. |
products.offers.price_details.base | string | Giá gốc. |
products.offers.price_details.total | string | Tổng giá bao gồm thuế và phí vận chuyển. |
products.offers.available | bool | Trạng thái khả dụng của sản phẩm. |
products.offers.details | string | Thông tin giao hàng và tồn kho. |
products.offers.url | string | URL thanh toán hoặc trang sản phẩm. |
products.rating_grouped_citation | object | Dữ liệu trích dẫn cho đánh giá. |
products.rating_grouped_citation.title | string | Tiêu đề trích dẫn. |
products.rating_grouped_citation.url | string | URL trích dẫn. |
products.rating_grouped_citation.supporting_websites | array | Các trang web hỗ trợ đánh giá. |
products.rating_grouped_citation.supporting_websites.title | string | Tiêu đề trang web. |
products.rating_grouped_citation.supporting_websites.url | string | URL trang web. |
ads | object | Thông tin quảng cáo do ChatGPT trả về. |
ads.type | string | Loại phản hồi quảng cáo, ví dụ: ads. |
ads.content | object | Nội dung quảng cáo. |
ads.content.type | string | Loại đơn vị quảng cáo, ví dụ: single_advertiser_ad_unit. |
ads.content.advertiser_brand | object | Thông tin thương hiệu nhà quảng cáo. |
ads.content.advertiser_brand.id | string | Định danh duy nhất cho thương hiệu nhà quảng cáo. |
ads.content.advertiser_brand.name | string | Tên thương hiệu nhà quảng cáo. |
ads.content.advertiser_brand.url | string | URL trang web thương hiệu nhà quảng cáo. |
ads.content.advertiser_brand.favicon_url | string | URL biểu tượng favicon của nhà quảng cáo. |
ads.content.ad_cards | array | Mảng các thẻ quảng cáo. |
ads.content.ad_cards.title | string | Tiêu đề của thẻ quảng cáo. |
ads.content.ad_cards.body | string | Văn bản nội dung hoặc mô tả quảng cáo. |
ads.content.ad_cards.company_name | string | Tên công ty quảng cáo. |
ads.content.ad_cards.format | string | Định dạng thẻ quảng cáo, ví dụ: image_card_v2. |
ads.content.ad_cards.image_url | string | URL hình ảnh quảng cáo. |
ads.content.ad_cards.cta_product_copy | string | Văn bản kêu gọi hành động cho sản phẩm (có thể là null). |
ads.content.ad_cards.card_header | object | Thông tin tiêu đề của thẻ quảng cáo. |
ads.content.ad_cards.card_header.title | string | Tiêu đề trong phần đầu thẻ. |
ads.content.ad_cards.card_header.subtitle | string | Phụ đề trong phần đầu thẻ, ví dụ: Sponsored. |
ads.content.ad_cards.card_header.logo_url | string | URL logo của nhà quảng cáo. |
ads.content.ad_cards.favicon_url | string | URL favicon cho quảng cáo. |
ads.content.ad_cards.target | object | Thông tin liên kết đích cho quảng cáo. |
ads.content.ad_cards.target.type | string | Loại đích, ví dụ: url. |
ads.content.ad_cards.target.value | string | Giá trị URL thực tế của liên kết đích. |
ads.content.ad_cards.target.open_externally | bool | Có mở liên kết ra ngoài ứng dụng hay không. |
ads.content.carousel_cards | array | Mảng các thẻ quảng cáo dạng carousel. |
ads.content.carousel_cards.title | string | Tiêu đề của thẻ carousel. |
ads.content.carousel_cards.body | string | Văn bản nội dung hoặc mô tả của thẻ carousel. |
ads.content.carousel_cards.image_url | string | URL hình ảnh của thẻ carousel. |
ads.content.carousel_cards.target | object | Thông tin liên kết đích cho thẻ carousel. |
ads.content.carousel_cards.target.type | string | Loại đích, ví dụ: url. |
ads.content.carousel_cards.target.value | string | Giá trị URL thực tế của đích carousel. |
ads.content.carousel_cards.target.open_externally | bool | Có mở liên kết carousel ra ngoài hay không. |
map | object | Dữ liệu bản đồ và doanh nghiệp địa phương do ChatGPT trả về. |
map.entities | array | Danh sách các thực thể đã được giải quyết theo thứ hạng (ví dụ: doanh nghiệp địa phương). |
map.entities.category | string | Danh mục thực thể, ví dụ: local_business. |
map.entities.id | string | Định danh thực thể (ví dụ: Google Place ID). |
map.entities.name | string | Tên thực thể. |
map.entities.latitude | float | Vĩ độ của thực thể. |
map.entities.longitude | float | Kinh độ của thực thể. |
map.entities.extra_params | object | Các tham số tra cứu bổ sung cho thực thể. |
map.entities.extra_params.address | string | Địa chỉ thực thể. |
map.entities.extra_params.business_id | string | Định danh doanh nghiệp. |
map.entities.extra_params.location | string | Ngữ cảnh vị trí tìm kiếm. |
map.entities.extra_params.provider | string | Nhà cung cấp dữ liệu, ví dụ: yelp-feed, b3. |
map.entities.entity | object | Bản ghi chi tiết của thực thể. |
map.entities.entity.address | string | Địa chỉ đường phố đầy đủ. |
map.entities.entity.attributes | object | Các thuộc tính bổ sung (có thể là null). |
map.entities.entity.categories | array | Nhãn danh mục cho thực thể. |
map.entities.entity.city | string | Thành phố (có thể là null). |
map.entities.entity.country_code | string | Mã quốc gia ISO, ví dụ: US. |
map.entities.entity.country_name | string | Tên quốc gia. |
map.entities.entity.date_closed | string | Ngày đóng cửa (có thể là null). |
map.entities.entity.date_opened | string | Ngày mở cửa (có thể là null). |
map.entities.entity.description | string | Mô tả doanh nghiệp (có thể là null). |
map.entities.entity.description_cite | string | Trích dẫn mô tả (có thể là null). |
map.entities.entity.distance_meters | float | Khoảng cách từ vị trí tìm kiếm tính bằng mét (có thể là null). |
map.entities.entity.enriched_description | string | Mô tả được làm giàu (có thể là null). |
map.entities.entity.from_cache | bool | Có được phục vụ từ bộ nhớ đệm hay không. |
map.entities.entity.hours | array | Giờ mở cửa theo ngày. |
map.entities.entity.hours.day | int | Ngày trong tuần (0=Chủ nhật … 6=Thứ bảy). |
map.entities.entity.hours.start | string | Giờ mở cửa theo định dạng 24h HHMM, ví dụ: 0800. |
map.entities.entity.hours.end | string | Giờ đóng cửa theo định dạng 24h HHMM, ví dụ: 1900. |
map.entities.entity.id | string | Định danh thực thể. |
map.entities.entity.image_url | string | URL hình ảnh chính. |
map.entities.entity.image_urls | array | Mảng các URL hình ảnh. |
map.entities.entity.is_claimed | bool | Có được xác nhận quyền sở hữu hay không (có thể là null). |
map.entities.entity.is_closed_permanently | bool | Có đóng cửa vĩnh viễn hay không. |
map.entities.entity.is_closed_temporarily | bool | Có đóng cửa tạm thời hay không. |
map.entities.entity.is_open | bool | Có đang mở cửa hiện tại hay không. |
map.entities.entity.latitude | float | Vĩ độ. |
map.entities.entity.location | string | Ngữ cảnh vị trí, ví dụ: Portland, OR, USA. |
map.entities.entity.longitude | float | Kinh độ. |
map.entities.entity.menu | object | Thông tin thực đơn (có thể là null). |
map.entities.entity.menu.url | string | URL thực đơn. |
map.entities.entity.name | string | Tên doanh nghiệp. |
map.entities.entity.next_open_hour | object | Khung giờ mở cửa tiếp theo. |
map.entities.entity.next_open_hour.day | int | Ngày trong tuần cho lần mở cửa tiếp theo. |
map.entities.entity.next_open_hour.start | string | Giờ mở cửa tiếp theo (HHMM). |
map.entities.entity.next_open_hour.end | string | Giờ đóng cửa tương ứng (HHMM). |
map.entities.entity.phone | string | Số điện thoại. |
map.entities.entity.popularity_score | float | Điểm phổ biến (có thể là null). |
map.entities.entity.price | string | Giá trị giá (có thể là null). |
map.entities.entity.price_str | string | Chỉ báo mức giá, ví dụ: $, $$ (có thể là null). |
map.entities.entity.provider | string | Nhà cung cấp nguồn, ví dụ: yelp-feed, b3, bright-feed. |
map.entities.entity.provider_images | array | Hình ảnh do nhà cung cấp cung cấp (có thể là null). |
map.entities.entity.provider_logo_dark_url | string | URL logo nhà cung cấp cho chế độ tối (có thể là null). |
map.entities.entity.provider_logo_url | string | URL logo nhà cung cấp (có thể là null). |
map.entities.entity.provider_url | string | URL của thực thể trên trang web nhà cung cấp. |
map.entities.entity.rank | int | Vị trí xếp hạng (có thể là null). |
map.entities.entity.ranking_score | float | Điểm xếp hạng nội bộ. |
map.entities.entity.rating | float | Đánh giá trung bình. |
map.entities.entity.rating_scale | int | Thang đánh giá tối đa, ví dụ: 5. |
map.entities.entity.reconciled_thumbnails | array | Hình thu nhỏ đã được đồng bộ hóa giữa các nhà cung cấp. |
map.entities.entity.reconciled_thumbnails.image_url | string | URL hình thu nhỏ. |
map.entities.entity.reconciled_thumbnails.obfuscated_provider | string | Tên nhà cung cấp đã được ẩn danh cho hình thu nhỏ. |
map.entities.entity.reservation_providers | array | Các nhà cung cấp dịch vụ đặt chỗ khả dụng. |
map.entities.entity.review_count | int | Số lượng đánh giá. |
map.entities.entity.review_highlights | array | Các đoạn trích đánh giá nổi bật (có thể là null). |
map.entities.entity.reviews | array | Bản ghi đánh giá (có thể là null). |
map.entities.entity.service_providers | array | Nhà cung cấp dịch vụ (có thể là null). |
map.entities.entity.special_hours | array | Giờ đặc biệt/lễ (có thể là null). |
map.entities.entity.state | string | Mã tiểu bang hoặc khu vực (có thể là null). |
map.entities.entity.tags | array | Thẻ thuộc tính, ví dụ: tính năng hỗ trợ tiếp cận. |
map.entities.entity.website_url | string | URL trang web chính thức. |
map.entities.entity.yelp_menu_url | string | URL thực đơn Yelp (có thể là null). |
map.entities.entity.zipcode | string | Mã ZIP/bưu chính (có thể là null). |
map.raw_search_entities | array | Các thực thể tìm kiếm thô, chưa xếp hạng. Mỗi mục có cùng cấu trúc với map.entities. |