Felo API PlatformFelo API Platform
Tất cả endpoint của DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tổng quan xếp hạng tên miền

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

Tổng quan xếp hạng tên miền

​

Dấu chân tìm kiếm của một tên miền: số lượng từ khóa organic và trả phí, lưu lượng ước tính và giá trị lưu lượng, theo location_code. Trả về se_type, target, total_count, items_count và items. Đượ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. Để có cùng các con số theo thời gian, dùng post_dataforseo_labs_google_historical_rank_live; cho nhiều tên miền cùng lúc, dùng post_dataforseo_labs_google_bulk_traffic_estimation_live.

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,0121 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.

Phần thân
application/json
  • Kiểu: array (object | null)[]
    • ignore_synonyms
      Kiểu: boolean | null

      bỏ qua các từ khóa có độ tương đồng cao
      trường tùy chọn
      nếu đặt thành true, mọi từ khóa có độ tương đồng cao sẽ bị loại khỏi việc tính thứ hạng và lưu lượng, kết quả sẽ dựa trên dữ liệu của các từ khóa chính trong nhóm từ đồng nghĩa
      giá trị mặc định: false

    • language_code
      Kiểu: string | null

      mã ngôn ngữ
      trường tùy chọn
      nếu bạn dùng trường này, bạn không cần chỉ định language_name
      bạn có thể nhận danh sách ngôn ngữ khả dụng cùng 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
      bỏ qua trường này để nhận kết quả cho tất cả ngôn ngữ khả dụng
      ví dụ:
      en

    • language_name
      Kiểu: string | null

      tên đầy đủ của ngôn ngữ
      trường tùy chọn
      nếu bạn dùng trường này, bạn không cần chỉ định language_code
      bạn có thể nhận danh sách ngôn ngữ khả dụng cùng 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
      bỏ qua trường này để nhận kết quả cho tất cả ngôn ngữ khả dụng
      ví dụ:
      English

    • limit
      Kiểu: integer | null

      số kết quả trả về tối đa cho tên miền
      trường tùy chọn
      giá trị mặc định: 100
      giá trị tối đa: 1000

    • location_code
      Kiểu: integer | null

      mã vị trí
      trường tùy chọn
      nếu bạn dùng trường này, bạn không cần chỉ định location_name
      bạn có thể nhận danh sách vị trí khả dụng cùng 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
      bỏ qua trường này để nhận kết quả cho tất cả vị trí khả dụng
      ví dụ:
      2840

    • location_name
      Kiểu: string | null

      tên đầy đủ của vị trí
      trường tùy chọn
      nếu bạn dùng trường này, bạn không cần chỉ định location_code
      bạn có thể nhận danh sách vị trí khả dụng cùng 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
      bỏ qua trường này để nhận kết quả cho tất cả vị trí khả dụng
      ví dụ:
      United Kingdom

    • offset
      Kiểu: integer | null

      độ lệch trong mảng kết quả của các mụ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 items đầ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 mục tiếp theo

    • 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

    • target
      Kiểu: string

      tên miền
      trường bắt buộc
      tên miền của website mục tiêu
      tên miền phải được chỉ định mà không có https:// và www.

Phản hồi
  • 200
    Kiểu: object | null · Response36Afe1097B20_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
        • 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 dữ liệu xếp hạng và lưu lượng truy cập

            • language_code
              Kiểu: string | null

              mã ngôn ngữ trong mảng POST

            • location_code
              Kiểu: integer | null

              mã vị trí trong mảng POST

            • metrics
              Kiểu: object | null

              dữ liệu xếp hạng liên quan đến tên miền được chỉ định

              • propertyName
                Kiểu: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Kiểu: object | null

                  phân bố các chỉ số dựa trên clickstream theo độ tuổi
                  để nhận kết quả cho trường này, tham số include_clickstream_data phải được đặt thành true
                  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

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

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Kiểu: number | null Định dạng: double

                  khối lượng lưu lượng truy cập ước tính dựa trên dữ liệu clickstream
                  được tính bằng tích của tỷ lệ nhấp và giá trị khối lượng tìm kiếm clickstream của tất cả từ khóa mà tên miền xếp hạng
                  để nhận kết quả cho trường này, tham số include_clickstream_data phải được đặt thành true
                  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

                • clickstream_gender_distribution
                  Kiểu: object | null

                  phân bố các chỉ số dựa trên clickstream ước tính theo giới tính
                  để nhận kết quả cho trường này, tham số include_clickstream_data phải được đặt thành true
                  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

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

                    Signed 64-bit integers (long type).

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

                  tổng số SERP organic có chứa tên miền hoặc tên miền phụ

                • estimated_paid_traffic_cost
                  Kiểu: number | null

                  chi phí ước tính để chuyển lưu lượng truy cập tìm kiếm organic thành trả phí
                  thể hiện chi phí hàng tháng ước tính (USD) để chạy quảng cáo cho tất cả từ khóa trong danh mục mà tên miền hoặc tên miền phụ xếp hạng
                  chỉ số được tính bằng tích của giá trị etv organic và cpc trả phí và cho biết chi phí đưa khối lượng lưu lượng organic hàng tháng ước tính qua quảng cáo PPC trên Google Search
                  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

                • etv
                  Kiểu: number | null

                  khối lượng lưu lượng truy cập ước tính
                  lưu lượng organic hàng tháng ước tính đến tên miền hoặc tên miền phụ
                  được tính bằng tích của CTR (tỷ lệ nhấp) và giá trị khối lượng tìm kiếm của tất cả từ khóa trong danh mục mà tên miền hoặc tên miền phụ xếp hạng
                  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

                • is_down
                  Kiểu: integer | null

                  thứ hạng giảm
                  cho biết có bao nhiêu phần tử được xếp hạng của mục tiêu được chỉ định đã giảm

                • is_lost
                  Kiểu: integer | null

                  phần tử được xếp hạng bị mất
                  cho biết có bao nhiêu phần tử được xếp hạng của mục tiêu được chỉ định trước đây đã xuất hiện trong SERP nhưng không được tìm thấy trong lần kiểm tra gần nhất

                • is_new
                  Kiểu: integer | null

                  số phần tử được xếp hạng mới
                  cho biết có bao nhiêu phần tử được xếp hạng mới được tìm thấy cho mục tiêu được chỉ định

                • is_up
                  Kiểu: integer | null

                  thứ hạng tăng
                  cho biết có bao nhiêu phần tử được xếp hạng của mục tiêu được chỉ định đã tăng

                • pos_1
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #1

                • pos_11_20
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #11-20

                • pos_2_3
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #2-3

                • pos_21_30
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #21-30

                • pos_31_40
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #31-40

                • pos_4_10
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #4-10

                • pos_41_50
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #41-50

                • pos_51_60
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #51-60

                • pos_61_70
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #61-70

                • pos_71_80
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #71-80

                • pos_81_90
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #81-90

                • pos_91_100
                  Kiểu: integer | null

                  số SERP organic nơi tên miền hoặc tên miền phụ xếp hạng #91-100

            • se_type
              Kiểu: string | null

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

          • 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ảng POST

          • location_code
            Kiểu: integer | null

            mã vị trí trong mảng POST

          • se_type
            Kiểu: string | null

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

          • target
            Kiểu: string | null

            tên miền mục tiêu trong mảng POST

          • 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
Request Example for post/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840
  }
]'

{
  "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,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "location_code": null,
              "language_code": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Domain Rank Overview