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

Tên miền con

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ên miền con

​

Các tên miền con của một target và dấu chân tìm kiếm của từng tên miền. Phân trang bằng limit, offset và offset_token; dùng token khi vượt qua các trang đầu. Đượ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. Hữu ích khi lưu lượng của một tên miền tập trung ở nơi khác ngoài www - một tên miền con docs hoặc blog gánh cả trang web sẽ không hiển thị trong post_dataforseo_labs_google_domain_rank_overview_live.

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.1356.
  • 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
      ví dụ:
      ["metrics.paid.count",">",0]

      [["metrics.paid.count",">",0],"and",["metrics.paid.etv",">","50"]]

      [["metrics.organic.count",">","10"],
      "and",
      [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
      để 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
    • historical_serp_mode
      Kiểu: string | null

      chế độ thu thập dữ liệu
      trường tùy chọn
      bạn có thể dùng trường này để lọc kết quả;
      các kiểu lọc khả dụng:
      live — trả về số liệu cho các SERP mà target đã chỉ định hiện có kết quả xếp hạng;
      lost — trả về số liệu cho các SERP mà target đã chỉ định từng có kết quả xếp hạng nhưng không có trong lần kiểm tra gần nhất;
      all — trả về số liệu cho cả hai loại SERP.
      giá trị mặc định: live

    • 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ỉ 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

    • 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
      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

    • item_types
      Kiểu: array string[] | null

      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 đưa vào phản hồi

      Lưu ý: nếu mảng item_types chứa các loại mục khác với organic, kết quả sẽ được sắp xếp theo loại mục đầu tiên trong mảng; bạn sẽ không thể sắp xếp và lọc kết quả theo các loại kết quả tìm kiếm không có trong phản hồi;

      các giá trị khả dụng:
      ["organic", "paid", "featured_snippet", "local_pack"]
      giá trị mặc định:
      ["organic", "paid"]

    • 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ố từ khóa 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 | 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 từ khóa đượ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ừ khóa đầ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ừ khóa 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
      bạn nên dùng dấu phẩy để chỉ định kiểu sắp xếp
      ví dụ:
      ["metrics.paid.etv,asc"]
      Lưu ý: bạn có thể đặt không 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ụ:
      ["metrics.organic.etv,desc","metrics.paid.count,asc"]

      quy tắc mặc định:
      ["metrics.organic.count,desc"]
      Lưu ý: nếu mảng item_types chứa các loại mục khác với organic, kết quả sẽ được sắp xếp theo loại mục đầu tiên trong mảng

    • 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_DataforseoLabsGoogleSubdomainsLiveResponseInfo
    • 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_DataforseoLabsGoogleSubdomainsLiveTaskInfo
        • 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 tên miền phụ và dữ liệu liên quan

            • metrics
              Kiểu: object | null

              dữ liệu xếp hạng liên quan đến tên miền phụ

              • 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

            • subdomain
              Kiểu: string | null

              tên miền phụ được trả về

          • 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 trong một 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/subdomains/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/subdomains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        0
      ]
    ]
  }
]'

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

Thao tác thành công

Subdomains