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 lịch sử

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 lịch sử

​

Tổng quan xếp hạng của một tên miền tại từng mốc trong lịch sử khả dụng. 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. Hãy kiểm tra get_dataforseo_labs_google_available_history trước - nó nêu các ngày tồn tại, và yêu cầu một ngày nằm ngoài đó sẽ trả về rỗng thay vì lỗi. Ảnh chụp hiện tại là post_dataforseo_labs_google_domain_rank_overview_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,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.

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

      tương quan dữ liệu với các tập dữ liệu đã lấy trước đó
      trường tùy chọn
      giá trị mặc định: true
      nếu bạn dùng tham số này, hệ thống của chúng tôi sẽ tương quan dữ liệu bạn lấy hiện tại với các tập dữ liệu đã lấy trước đó
      tham số này nhằm giảm thiểu mọi sai lệch có thể phát sinh từ thay đổi đối với cơ sở dữ liệu của chúng tôi
      chúng tôi khuyên bạn luôn đặt correlate thành true

    • date_from
      Kiểu: string | null

      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 6 tháng trước
      giá trị tối thiểu khả dụng: 2020-10-01
      định dạng ngày: "yyyy-mm-dd"

    • date_to
      Kiểu: string | null

      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"

    • 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, chỉ dữ liệu dựa trên các từ khóa chính sẽ được trả về, dữ liệu cho mọi từ khóa có độ tương đồng cao sẽ bị loại trừ;
      giá trị mặc định: false

    • include_clickstream_data
      Kiểu: boolean | null

      bao gồm hoặc loại trừ dữ liệu từ các chỉ số dựa trên clickstream trong kết quả
      trường tùy chọn
      nếu tham số được đặt thành true, bạn sẽ nhận được các trường clickstream_etv, clickstream_gender_distribution và clickstream_age_distribution cùng dữ liệu clickstream trong phản hồi;
      giá trị mặc định: false;

      Lưu ý: dữ liệu clickstream lịch sử có từ 2024/05 (tháng 5 năm 2024);
      khi bật tham số này, bạn sẽ bị tính gấp đôi giá cho yêu cầu;
      tìm hiểu thêm về cách tính các chỉ số dựa trên clickstream trong bài viết trung tâm trợ giúp này

    • language_code
      Kiểu: string | null

      mã ngôn ngữ
      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 vị trí 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
      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 vị trí 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
      ví dụ:
      English

    • location_code
      Kiểu: integer

      mã vị trí
      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 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 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

    • 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_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
        • 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 lịch sử

            • 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

            • month
              Kiểu: integer | null

              tháng mà dữ liệu được cung cấp

            • se_type
              Kiểu: string | null

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

            • year
              Kiểu: integer | null

              năm mà dữ liệu được cung cấp

          • 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/historical_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

{
  "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,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Historical Rank Overview