DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Ước tính lưu lượng hàng loạt lịch sử
Lưu lượng truy cập organic ước tính cho nhiều tên miền tại từng mốc trong lịch sử khả dụng - chuỗi thời gian đằng sau post_dataforseo_labs_google_bulk_traffic_estimation_live. Endpoint này không nhận tham số giới hạn, nhưng được tính giá theo lần gọi chứ không theo từng mục, nên hãy gửi toàn bộ danh sách một lần. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong tasks[0].result, kết quả trong tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. ⚠️ Kích thước phản hồi nhân số tên miền với số ngày; hãy giữ cả hai danh sách ngắn. Các ngày khả dụng lấy từ get_dataforseo_labs_google_available_history.
Tham chiếu giá
- Cách tính: chi phí phản hồi được báo cáo.
- Ước tính tham chiếu mỗi yêu cầu: 0,1356 USD.
- Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này 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)[]
- dateKiểu: string | null
_from ngày bắt đầu của khoảng thời gian
trường tùy chọn
nếu bạn không chỉ định trường này, dữ liệu sẽ được cung cấp cho 12 tháng trước
giá trị tối thiểu khả dụng:2020-10-01
định dạng ngày:"yyyy-mm-dd" - dateKiểu: string | null
_to ngày kết thúc của khoảng thời gian
trường tùy chọn
nếu bạn không chỉ định trường này, ngày hôm nay sẽ được dùng theo mặc định;
định dạng ngày:"yyyy-mm-dd"
ví dụ:"2021-04-01" - ignoreKiểu: boolean | null
_synonyms bỏ qua các từ khóa có độ tương đồng cao
trường tùy chọn
nếu đặt thànhtrue, chỉ các từ khóa chính sẽ được trả về, mọi từ khóa có độ tương đồng cao sẽ bị loại trừ;
giá trị mặc định:false - itemKiểu: array string[] | null
_types hiển thị kết quả theo loại mục
trường tùy chọn
cho biết loại kết quả tìm kiếm được bao gồm trong phản hồi;
Lưu ý: nếu mảngitem_typeschứa các loại mục khác vớiorganic, kết quả sẽ được sắp xếp theo loại mục đầu tiên trong mảng;
giá trị khả dụng:["organic", "paid", "featured_snippet", "local_pack"]
giá trị mặc định:["organic", "paid"] - languageKiểu: string | null
_code mã ngôn ngữ
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ùnglanguage_codecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
bỏ qua trường này để nhận kết quả cho tất cả ngôn ngữ khả dụng
ví dụ:en - languageKiểu: string | null
_name tên đầy đủ của ngôn ngữ
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ùnglanguage_namecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
bỏ qua trường này để nhận kết quả cho tất cả ngôn ngữ khả dụng
ví dụ:English - locationKiểu: integer | null
_code mã vị trí
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ùnglocation_codecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
bỏ qua trường này để nhận kết quả cho tất cả vị trí khả dụng
ví dụ:2840 - locationKiểu: string | null
_name tên đầy đủ của vị trí
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ùnglocation_namecủa chúng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
bỏ qua trường này để nhận kết quả cho tất cả vị trí khả dụng
ví dụ:United Kingdom - 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 - targetsKiểu: array string[]
tên miền và tên miền con mục tiêu
trường bắt buộc
bạn có thể chỉ định tên miền và tên miền con trong trường này;
tên miền và tên miền con phải được chỉ định mà không cóhttps://vàwww.;
bạn có thể đặt tối đa 1000 tên miền hoặc tên miền con
- Kiểu: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo200
- 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_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo
- 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ả
- itemsKiểu: array (object | null)[] | null
mảng các mục với dữ liệu ước tính lưu lượng truy cập liên quan
- metricsKiểu: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo
dữ liệu lưu lượng truy cập liên quan đến tên miền được chỉ định
- featuredKiểu: array (object | null)[] | null
_snippet dữ liệu lưu lượng từ kết quả đoạn trích nổi bật trong SERP Google
- countKiểu: integer | null Định dạng: int64
tổng số SERP organic có chứa tên miền
- etvKiểu: number | null
- monthKiểu: integer | null
tháng mà dữ liệu được cung cấp
- yearKiểu: integer | null
năm mà dữ liệu được cung cấp
- localKiểu: array (object | null)[] | null
_pack dữ liệu lưu lượng từ kết quả gói địa phương trong SERP
- countKiểu: integer | null Định dạng: int64
tổng số SERP organic có chứa tên miền
- etvKiểu: number | null
- monthKiểu: integer | null
tháng mà dữ liệu được cung cấp
- yearKiểu: integer | null
năm mà dữ liệu được cung cấp
- organicKiểu: array (object | null)[] | null
dữ liệu lưu lượng từ tìm kiếm organic
- countKiểu: integer | null Định dạng: int64
tổng số SERP organic có chứa tên miền
- etvKiểu: number | null
- monthKiểu: integer | null
tháng mà dữ liệu được cung cấp
- yearKiểu: integer | null
năm mà dữ liệu được cung cấp
- paidKiểu: array (object | null)[] | null
dữ liệu lưu lượng từ tìm kiếm trả phí
- countKiểu: integer | null Định dạng: int64
tổng số SERP organic có chứa tên miền
- etvKiểu: number | null
- monthKiểu: integer | null
tháng mà dữ liệu được cung cấp
- yearKiểu: integer | null
năm mà dữ liệu được cung cấp
- seKiểu: string | null
_type loại công cụ tìm kiếm
- targetKiểu: string | null
tên miền mục tiêu trong mảng POST
- itemsKiểu: integer | null Định dạng: int64
_count số lượng kết quả được trả về trong mảng
items - languageKiểu: string | null
_code mã ngôn ngữ trong một mảng POST
nếu không có dữ liệu, giá trị lànull - locationKiểu: integer | null
_code mã vị trí trong một mảng POST
nếu không có dữ liệu, giá trị lànull - seKiểu: string | null
_type loại công cụ tìm kiếm
- totalKiểu: integer | null Định dạng: int64
_count tổng số kết quả trong cơ sở dữ liệu của chúng tôi liên quan đến yêu cầu của bạ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/dataforseo_labs/google/historical_bulk_traffic_estimation/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
"dataforseo.com",
"cnn.com",
"forbes.com"
],
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29",
"item_types": [
"organic",
"paid"
]
}
]'
{
"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": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"target": null,
"metrics": "[Max Depth Exceeded]"
}
]
}
]
}
]
}