v0.2.0-beta

OpenAPI 3.1.0

Đối thủ SERP

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Thao tác

post/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live

Đối thủ SERP

Các tên miền xếp hạng cùng bạn cho một tập keywords, kèm số từ khóa họ chia sẻ. Trả về se_type, seed_keywords, total_count, items_count và items. Đượ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à đối thủ tìm kiếm, được quyết định bởi thứ hạng chung. Tương đương trên đồ thị liên kết là post_dataforseo_backlinks_competitors_live, và hai danh sách thường không khớp - bản thân điều đó cũng mang thông tin.

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.0192.
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.

Phần thân

application/json

Kiểu: array (object | null)[]
- filters
  Kiểu: array (object | null)[] | null
  
  mảng tham số lọc kết quả
  trường tùy chọn
  bạn có thể thêm nhiều bộ lọc cùng lúc (tối đa 8 bộ lọc)
  bạn nên đặt toán tử logic and, or giữa các điều kiện
  các toán tử sau được hỗ trợ:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  bạn có thể dùng toán tử % với like và not_like, cũng như ilike và not_ilike để khớp mọi chuỗi có 0 hoặc nhiều ký tự
  ví dụ:
  ["median_position","in",[1,10]]
  
  [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]
  
  [["domain","not_like","%wikipedia.org%"], "and", [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
  để biết thêm thông tin về bộ lọc, vui lòng tham khảo Dataforseo Labs - Filters hoặc hướng dẫn của trung tâm trợ giúp
  
  Đối tượng rỗng
- include_subdomains
  Kiểu: boolean | null
  
  cho biết các tên miền con có được đưa vào tìm kiếm hay không
  trường tùy chọn
  nếu đặt thành false, các tên miền con sẽ bị bỏ qua
  giá trị mặc định: true
- item_types
  Kiểu: array string[] | null
  
  loại kết quả tìm kiếm
  cho biết loại kết quả tìm kiếm được đưa vào phản hồi
  trường tùy chọn
  
  các giá trị khả dụng:
  ["organic", "paid", "featured_snippet", "local_pack"]
  giá trị mặc định:
  ["organic", "paid"]
- keywords
  Kiểu: array string[]
  
  mảng từ khóa
  trường bắt buộc
  kết quả sẽ dựa trên các từ khóa bạn chỉ định trong mảng này
  mã hóa UTF-8;
  các từ khóa sẽ được chuyển thành định dạng chữ thường;
  bạn có thể chỉ định tối đa 200 từ khóa
  
  tìm hiểu thêm về quy tắc và giới hạn của các trường keyword và keywords trong API DataForSEO tại bài viết Trung tâm trợ giúp
- language_code
  Kiểu: string | null
  
  mã định danh ngôn ngữ duy nhất
  trường bắt buộc nếu bạn không chỉ định language_name
  Lưu ý: cần chỉ định language_name hoặc language_code
  bạn có thể nhận danh sách ngôn ngữ khả dụng cùng các tham số language_code của chúng bằng cách gửi một yêu cầu riêng đến
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ví dụ:
  en
- language_name
  Kiểu: string
  
  tên đầy đủ của ngôn ngữ
  trường bắt buộc nếu bạn không chỉ định language_code
  Lưu ý: cần chỉ định language_name hoặc language_code
  bạn có thể nhận danh sách ngôn ngữ khả dụng cùng các tham số language_name của chúng bằng cách gửi một yêu cầu riêng đến
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ví dụ:
  English
- limit
  Kiểu: integer | null
  
  số lượng tên miền trả về tối đa
  trường tùy chọn
  giá trị mặc định: 100
  giá trị tối đa: 1000
- location_code
  Kiểu: integer
  
  mã định danh vị trí duy nhất
  trường bắt buộc nếu bạn không chỉ định location_name
  Lưu ý: cần chỉ định location_name hoặc location_code
  bạn có thể nhận danh sách vị trí khả dụng cùng các tham số location_code của chúng bằng cách gửi một yêu cầu riêng đến
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ví dụ:
  2840
- location_name
  Kiểu: string
  
  tên đầy đủ của vị trí
  trường bắt buộc nếu bạn không chỉ định location_code
  Lưu ý: cần chỉ định location_name hoặc location_code
  bạn có thể nhận danh sách vị trí khả dụng cùng các tham số location_name của chúng bằng cách gửi một yêu cầu riêng đến
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ví dụ:
  United Kingdom
- offset
  Kiểu: integer | null
  
  độ lệch trong mảng kết quả của các tên miền được trả về
  trường tùy chọn
  giá trị mặc định: 0
  nếu bạn chỉ định giá trị 10, mười tên miền đầu tiên trong mảng kết quả sẽ bị bỏ qua và dữ liệu sẽ được cung cấp cho các tên miền tiếp theo
- order_by
  Kiểu: array string[] | null
  
  quy tắc sắp xếp kết quả
  trường tùy chọn
  bạn có thể dùng các giá trị giống như trong mảng filters để sắp xếp kết quả
  các kiểu sắp xếp khả dụng:
  asc - kết quả được sắp xếp theo thứ tự tăng dần
  desc - kết quả được sắp xếp theo thứ tự giảm dần
  dấu phẩy được dùng làm dấu phân tách
  ví dụ:
  ["avg_position,asc"]
  quy tắc mặc định:
  ["rating,desc"]
  lưu ý bạn không thể đặt quá ba quy tắc sắp xếp trong một yêu cầu
  bạn nên dùng dấu phẩy để phân tách nhiều quy tắc sắp xếp
  ví dụ:
  ["avg_position,asc","etv,desc"]
- tag
  Kiể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ượng data của phản hồi

Phản hồi

200
Kiểu: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
cost
Kiểu: number | null Định dạng: double

tổng chi phí tác vụ, USD

status_code
Kiểu: integer | null

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

status_message
Kiểu: string | null

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

tasks
Kiểu: array (object | null)[] | null

mảng tác vụ

Kiểu: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
cost
Kiểu: number | null Định dạng: double

tổng chi phí tác vụ, USD

data
Kiểu: object | null

chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST

propertyName
Kiểu: object | null
id
Kiể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

path
Kiểu: array (string | null)[] | null

Đường dẫn URL

result
Kiểu: array (object | null)[] | null

mảng kết quả

items
Kiểu: array (object | null)[] | null

chứa các đối thủ SERP được phát hiện và dữ liệu liên quan

avg_position
Kiểu: number | null Định dạng: float

vị trí trung bình của tên miền cho các từ khóa được chỉ định
trung bình cộng của các giá trị trong mảng keywords_positions

domain
Kiểu: string | null

tên miền của đối thủ SERP được phát hiện

etv
Kiểu: number | null

khối lượng lưu lượng truy cập ước tính
thể hiện lưu lượng truy cập hàng tháng ước tính mà các từ khóa được chỉ định đang mang đến cho website
được tính bằng tổng của tích giữa giá trị khối lượng tìm kiếm của các từ khóa được chỉ định và tỷ lệ CTR (tỷ lệ nhấp) tại các vị trí nhất định trong SERP
tìm hiểu thêm về cách tính chỉ số trong bài viết trung tâm trợ giúp này

keywords_count
Kiểu: integer | null Định dạng: int64

số từ khóa được chỉ định mà tên miền có vị trí trong SERP

keywords_positions
Kiểu: object | null

vị trí từ khóa
vị trí SERP mà tên miền liên quan nắm giữ trong SERP cho các từ khóa được chỉ định

propertyName
Kiểu: array (integer | null)[] | null
median_position
Kiểu: number | null

vị trí trung vị của tên miền cho các từ khóa được chỉ định
trung vị của các giá trị trong mảng keywords_positions

rating
Kiểu: number | null

khoảng cách giữa vị trí từ khóa lớn nhất có thể và vị trí thực tế
thể hiện tỷ lệ hiển thị tương đối của tên miền trong SERP cho các từ khóa được chỉ định
được tính là sum(100-keywords_positions)

relevant_serp_items
Kiểu: integer | null

số phần tử SERP liên quan đến tên miền
thể hiện số kết quả tìm kiếm trong SERP liên quan đến tên miền cho các từ khóa được chỉ định

se_type
Kiểu: string | null

loại công cụ tìm kiếm

visibility
Kiểu: number | null

tỷ lệ hiển thị SERP
thể hiện tỷ lệ hiển thị của website dựa trên vị trí SERP của các từ khóa được chỉ định
các từ khóa có vị trí trong khoảng 1 đến 10 được gán chỉ số hiển thị tương ứng từ 1 đến 0,1
các từ khóa có vị trí trong khoảng 11 đến 20 có chỉ số hiển thị cố định là 0,05
các từ khóa có vị trí từ 20 đến 100 có chỉ số hiển thị bằng 0

items_count
Kiểu: integer | null Định dạng: int64

số lượng kết quả được trả về trong mảng items

language_code
Kiểu: string | null

mã ngôn ngữ trong một mảng POST
nếu không có dữ liệu, giá trị là_nulln

location_code
Kiểu: integer | null

mã vị trí trong một mảng POST
nếu không có dữ liệu, giá trị là_nulln

se_type
Kiểu: string | null

loại công cụ tìm kiếm

seed_keywords
Kiểu: array (string | null)[] | null

các từ khóa được chỉ định trong yêu cầu
từ khóa được trả về với %## đã giải mã (ký tự cộng '+' sẽ được giải mã thành ký tự dấu cách)

total_count
Kiểu: integer | null Định dạng: int64

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

result_count
Kiểu: integer | null Định dạng: int64

số phần tử trong mảng kết quả

status_code
Kiểu: integer | null

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

status_message
Kiểu: string | null

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

time
Kiểu: string | null

thời gian thực thi, giây

tasks_count
Kiểu: integer | null Định dạng: int64

số lượng tác vụ trong mảng tasks

tasks_error
Kiểu: integer | null Định dạng: int64

số lượng tác vụ trong mảng tasks được trả về kèm lỗi

time
Kiểu: string | null

tổng thời gian thực thi, giây

version
Kiểu: string | null

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

post/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "limit": 5
  }
]'

Hiện schema

{
  "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,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Đối thủ SERP

Xác thựcRequired

DataForSEO

Đối thủ SERP

Tham chiếu giá