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

Ý tưởng từ khóa

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 từ khóa

​

Mở rộng keywords hạt giống thành các ý tưởng chia sẻ không gian ngữ nghĩa của chúng. Trả về seed_keywords, total_count, items_count, offset, offset_token và items. Phân trang bằng limit, offset và offset_token; dùng token cho các trang sau trang đầu. Đượ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 ưu tiên endpoint này. Để có các biến thể của một cụm từ thay vì không gian rộng hơn, dùng post_dataforseo_labs_google_keyword_suggestions_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,132 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)[]
    • closely_variants
      Kiểu: boolean | null

      chế độ tìm kiếm
      trường tùy chọn
      nếu đặt thành true, kết quả sẽ dựa trên thuật toán tìm kiếm khớp cụm từ
      nếu đặt thành false, kết quả sẽ dựa trên thuật toán tìm kiếm khớp rộng
      giá trị mặc định: false

    • 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, not_ilike để khớp mọi chuỗi có 0 hoặc nhiều ký tự
      lưu ý rằng bạn không thể lọc kết quả theo relevance
      ví dụ:
      ["keyword_info.search_volume",">",0]

      [["keyword_info.search_volume","in",[0,1000]],
      "and",
      ["keyword_info.competition_level","=","LOW"]]

      [["keyword_info.search_volume",">",100],
      "and",
      [["keyword_info.cpc","<",0.5],
      "or",

      ["keyword_info.high_top_of_page_bid","<=",0.5]]]
      để biết thêm thông tin về bộ lọc, hãy tham khảo Dataforseo Labs - Filters hoặc hướng dẫn trung tâm trợ giúp này

      Đối tượng rỗng
    • 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_keyword_info, keyword_info_normalized_with_clickstream và keyword_info_normalized_with_bing 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

    • include_serp_info
      Kiểu: boolean | null

      bao gồm dữ liệu từ SERP cho mỗi từ khóa
      trường tùy chọn
      nếu đặt thành true, chúng tôi sẽ trả về một mảng serp_info chứa dữ liệu SERP (số kết quả tìm kiếm, URL liên quan và các tính năng SERP) cho mọi từ khóa trong phản hồi
      giá trị mặc định: false

    • keywords
      Kiểu: array string[]

      từ khóa
      trường bắt buộc
      mã hóa UTF-8
      Số lượng từ khóa tối đa bạn có thể chỉ định: 200.
      Các từ khóa sẽ được chuyển thành định dạng chữ thường

      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ã 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
      ví dụ:
      en
      Lưu ý: nếu bỏ qua, kết quả sẽ mặc định theo ngôn ngữ có nhiều bản ghi từ khóa nhất tại vị trí đã chỉ định;
      hãy tham khảo trường available_languages.keywords của endpoint Locations and Languages để xác định ngôn ngữ mặc định

    • 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
      ví dụ:
      English
      Lưu ý: nếu bỏ qua, kết quả sẽ mặc định theo ngôn ngữ có nhiều bản ghi từ khóa nhất tại vị trí đã chỉ định;
      hãy tham khảo trường available_languages.keywords của endpoint Locations and Languages để xác định ngôn ngữ mặc định

    • limit
      Kiểu: integer | null

      số lượng từ khóa tối đa trong mảng kết quả
      trường tùy chọn
      giá trị mặc định: 700
      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 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

    • 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
      Lưu ý: chúng tôi khuyến nghị chỉ dùng tham số này khi lấy tối đa 10.000 kết quả
      để lấy hơn 10.000 kết quả, hãy dùng offset_token thay thế.

    • offset_token
      Kiểu: string | null

      token offset cho các yêu cầu tiếp theo
      trường tùy chọn
      được cung cấp trong trường tương ứng của phản hồi cho mỗi yêu cầu;
      dùng tham số này để tránh hết thời gian chờ khi cố lấy hơn 10.000 kết quả trong một yêu cầu;
      bằng cách chỉ định giá trị offset_token duy nhất từ mảng phản hồi, bạn sẽ nhận được kết quả tiếp theo của tác vụ ban đầu;
      giá trị offset_token là duy nhất cho mỗi tác vụ tiếp theo
      Lưu ý: nếu offset_token được chỉ định trong yêu cầu, tất cả tham số khác ngoài limit sẽ không được xem xét khi xử lý tác vụ.
      tìm hiểu thêm về tham số này trên Trung tâm trợ giúp của chúng tôi

    • 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 để thiết lập tham số sắp xếp

      quy tắc mặc định:
      ["relevance,desc"]
      relevance được dùng làm quy tắc sắp xếp mặc định để cung cấp cho bạn những ý tưởng từ khóa gần nhất. Chúng tôi khuyến nghị dùng quy tắc sắp xếp này để có các cụm từ tìm kiếm có độ liên quan cao. Lưu ý rằng relevance chỉ là mã định danh nội bộ của hệ thống chúng tôi, nên không thể dùng làm bộ lọc, và bạn sẽ không thấy trường này trong mảng result. Điểm liên quan dựa trên nguyên tắc tương tự như được dùng trong endpoint Keywords For Keywords.

      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ụ:
      ["relevance,desc","keyword_info.search_volume,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_DataforseoLabsGoogleKeywordIdeasLiveResponseInfo
    • 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_DataforseoLabsGoogleKeywordIdeasLiveTaskInfo
        • 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 ý tưởng từ khóa và dữ liệu liên quan

            • avg_backlinks_info
              Kiểu: object | null · Response36Afe1097B20_AvgBacklinksInfo

              dữ liệu backlink của từ khóa được trả về
              đối tượng này cung cấp số backlink, trang và tên miền giới thiệu trung bình, cùng giá trị thứ hạng trung bình trong top 10 trang web xếp hạng organic cho từ khóa

              • backlinks
                Kiểu: number | null

                số lượng liên kết ngược trung bình

              • dofollow
                Kiểu: number | null

                số lượng liên kết dofollow trung bình

              • last_updated_time
                Kiểu: string | null

                ngày và giờ cập nhật dữ liệu từ khóa
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ví dụ:
                2019-11-15 12:57:46 +00:00

              • main_domain_rank
                Kiểu: number | null

                thứ hạng miền chính trung bình
                tìm hiểu thêm về chỉ số và công thức tính của nó trong bài viết Trung tâm trợ giúp này

              • rank
                Kiểu: number | null

                thứ hạng trung bình
                tìm hiểu thêm về chỉ số và công thức tính trong bài viết trung tâm trợ giúp này

              • referring_domains
                Kiểu: number | null

                số tên miền giới thiệu trung bình

              • referring_main_domains
                Kiểu: number | null

                số tên miền chính giới thiệu trung bình

              • referring_pages
                Kiểu: number | null

                số trang giới thiệu trung bình

              • se_type
                Kiểu: string | null

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

            • clickstream_keyword_info
              Kiểu: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              dữ liệu clickstream của từ khóa được trả về
              để lấy kết quả cho trường này, tham số include_clickstream_data phải được đặt thành true

              • age_distribution
                Kiểu: object | null

                phân bố các chỉ số dựa trên luồng nhấp theo độ tuổi
                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).

              • gender_distribution
                Kiểu: object | null

                phân bố các chỉ số dựa trên luồng nhấp theo giới tính
                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).

              • last_updated_time
                Kiểu: string | null

                ngày và giờ cập nhật dữ liệu từ khóa
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ví dụ:
                2019-11-15 12:57:46 +00:00

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

                lượng tìm kiếm hàng tháng
                đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa này (theo dữ liệu có sẵn trong mười hai tháng qua), nhắm đến các vị trí địa lý đã chỉ định

                • month
                  Kiểu: integer | null

                  tháng

                • search_volume
                  Kiểu: integer | null

                  lượng tìm kiếm trung bình hàng tháng

                • year
                  Kiểu: integer | null

                  năm

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

                tỷ lệ khối lượng tìm kiếm trung bình hàng tháng
                đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa đã cho trên google.com

            • keyword
              Kiểu: string | null

              ý tưởng từ khóa được trả về

            • keyword_info
              Kiểu: object | null · Response36Afe1097B20_KeywordInfo

              dữ liệu từ khóa cho ý tưởng từ khóa được trả về

              • categories
                Kiểu: array integer[] | null

                danh mục sản phẩm và dịch vụ
                bạn có thể tải xuống danh sách đầy đủ các danh mục khả dụng

              • competition
                Kiểu: number | null

                cạnh tranh
                biểu thị mức độ cạnh tranh tương đối gắn với từ khóa đã cho. Giá trị này dựa trên dữ liệu Google Ads và nằm trong khoảng 0 đến 1 (bao gồm hai đầu)

              • competition_level
                Kiểu: string | null

                mức độ cạnh tranh
                biểu thị mức cạnh tranh tương đối gắn với từ khóa đã cho, chỉ trong SERP trả phí;
                giá trị khả dụng: LOW, MEDIUM, HIGH
                nếu không xác định được mức độ cạnh tranh, giá trị là null;
                tìm hiểu thêm về chỉ số này trong bài viết trung tâm trợ giúp này

              • cpc
                Kiểu: number | null

                chi phí mỗi lần nhấp
                biểu thị chi phí trung bình mỗi lần nhấp (USD) mà từ khóa đã phải trả trong lịch sử

              • high_top_of_page_bid
                Kiểu: number | null

                giá thầu tối đa để quảng cáo hiển thị ở đầu trang đầu tiên
                cho biết giá trị lớn hơn khoảng 80% mức giá thầu thấp nhất mà quảng cáo đã được hiển thị (dựa trên thống kê Google Ads cho nhà quảng cáo)
                giá trị có thể khác nhau tùy theo vị trí được chỉ định trong yêu cầu POST

              • last_updated_time
                Kiểu: string | null

                ngày và giờ cập nhật dữ liệu từ khóa
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ví dụ:
                2019-11-15 12:57:46 +00:00

              • low_top_of_page_bid
                Kiểu: number | null

                giá thầu tối thiểu để quảng cáo hiển thị ở đầu trang đầu tiên
                cho biết giá trị lớn hơn khoảng 20% mức giá thầu thấp nhất mà quảng cáo đã được hiển thị (dựa trên thống kê Google Ads cho nhà quảng cáo)
                giá trị có thể khác nhau tùy theo vị trí được chỉ định trong yêu cầu POST

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

                lượng tìm kiếm hàng tháng
                đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa này (theo dữ liệu có sẵn trong mười hai tháng qua), nhắm đến các vị trí địa lý đã chỉ định

                • month
                  Kiểu: integer | null

                  tháng

                • search_volume
                  Kiểu: integer | null

                  lượng tìm kiếm trung bình hàng tháng

                • year
                  Kiểu: integer | null

                  năm

              • se_type
                Kiểu: string | null

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

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

                tỷ lệ khối lượng tìm kiếm trung bình hàng tháng
                đại diện cho số lượng tìm kiếm (gần đúng) cho ý tưởng từ khóa đã cho trên google.com

              • search_volume_trend
                Kiểu: object | null · Response36Afe1097B20_SearchVolumeTrend

                thay đổi xu hướng lượng tìm kiếm
                biểu thị mức thay đổi lượng tìm kiếm theo phần trăm so với giai đoạn trước

                • monthly
                  Kiểu: integer | null

                  thay đổi lượng tìm kiếm theo phần trăm so với tháng trước

                • quarterly
                  Kiểu: integer | null

                  thay đổi lượng tìm kiếm theo phần trăm so với quý trước

                • yearly
                  Kiểu: integer | null

                  thay đổi lượng tìm kiếm theo phần trăm so với năm trước

            • keyword_info_normalized_with_bing
              Kiểu: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              chứa khối lượng tìm kiếm từ khóa được chuẩn hóa theo khối lượng tìm kiếm Bing

              • is_normalized
                Kiểu: boolean | null

                thông tin từ khóa được chuẩn hóa nếu true, các giá trị được chuẩn hóa với dữ liệu Bing

              • last_updated_time
                Kiểu: string | null

                ngày và giờ cập nhật bộ dữ liệu theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” ví dụ: 2019-11-15 12:57:46 +00:00

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

                tốc độ lượng tìm kiếm hàng tháng mảng các đối tượng chứa lượng tìm kiếm trong một tháng cụ thể của năm

                • month
                  Kiểu: integer | null

                  tháng

                • search_volume
                  Kiểu: integer | null

                  lượng tìm kiếm trung bình hàng tháng

                • year
                  Kiểu: integer | null

                  năm

              • search_volume
                Kiểu: integer | null

                lượng tìm kiếm hiện tại của một từ khóa

            • keyword_info_normalized_with_clickstream
              Kiểu: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              chứa khối lượng tìm kiếm từ khóa được chuẩn hóa theo dữ liệu clickstream

              • is_normalized
                Kiểu: boolean | null

                thông tin từ khóa được chuẩn hóa nếu true, các giá trị được chuẩn hóa với dữ liệu Bing

              • last_updated_time
                Kiểu: string | null

                ngày và giờ cập nhật bộ dữ liệu theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00” ví dụ: 2019-11-15 12:57:46 +00:00

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

                tốc độ lượng tìm kiếm hàng tháng mảng các đối tượng chứa lượng tìm kiếm trong một tháng cụ thể của năm

                • month
                  Kiểu: integer | null

                  tháng

                • search_volume
                  Kiểu: integer | null

                  lượng tìm kiếm trung bình hàng tháng

                • year
                  Kiểu: integer | null

                  năm

              • search_volume
                Kiểu: integer | null

                lượng tìm kiếm hiện tại của một từ khóa

            • keyword_properties
              Kiểu: object | null · Response36Afe1097B20_KeywordProperties

              thông tin bổ sung về từ khóa

              • core_keyword
                Kiểu: string | null

                từ khóa chính trong một nhóm
                chứa từ khóa chính trong một nhóm do thuật toán phân cụm từ đồng nghĩa xác định
                nếu giá trị là null, cơ sở dữ liệu của chúng tôi không có từ khóa nào mà thuật toán tương ứng có thể xác định là đồng nghĩa với keyword

              • detected_language
                Kiểu: string | null

                ngôn ngữ được phát hiện của từ khóa
                cho biết ngôn ngữ của từ khóa do hệ thống của chúng tôi xác định

              • is_another_language
                Kiểu: boolean | null

                ngôn ngữ được phát hiện của từ khóa khác với ngôn ngữ đã đặt
                nếu true, ngôn ngữ đặt trong yêu cầu không khớp với ngôn ngữ mà hệ thống của chúng tôi xác định cho từ khóa đã cho

              • keyword_difficulty
                Kiểu: integer | null

                độ khó xếp hạng trong top 10 kết quả tìm kiếm tự nhiên đầu tiên cho một từ khóa
                cho biết khả năng lọt vào top 10 kết quả tự nhiên cho một từ khóa trên thang đo logarit từ 0 đến 100;
                được tính bằng cách phân tích, cùng các tham số khác, hồ sơ liên kết của 10 trang đầu trong SERP;
                tìm hiểu thêm về chỉ số này trong hướng dẫn trung tâm trợ giúp này

              • se_type
                Kiểu: string | null

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

              • synonym_clustering_algorithm
                Kiểu: string | null

                thuật toán dùng để xác định từ đồng nghĩa
                giá trị khả dụng:
                keyword_metrics - biểu thị thuật toán dựa trên các tham số keyword_info
                text_processing - biểu thị thuật toán dựa trên văn bản
                nếu giá trị là null, cơ sở dữ liệu của chúng tôi không có từ khóa nào mà thuật toán tương ứng có thể xác định là đồng nghĩa với keyword

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

                số từ trong từ khóa
                cho biết từ khóa gồm bao nhiêu từ

            • 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

            • search_intent_info
              Kiểu: object | null · Response36Afe1097B20_SearchIntentInfo

              thông tin ý định tìm kiếm của từ khóa được trả về
              tìm hiểu về ý định tìm kiếm trong bài viết trung tâm trợ giúp này

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

                ý định tìm kiếm bổ sung
                giá trị khả dụng: informational, navigational, commercial, transactional

              • last_updated_time
                Kiểu: string | null

                ngày và giờ cập nhật dữ liệu từ khóa
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ví dụ:
                2019-11-15 12:57:46 +00:00

              • main_intent
                Kiểu: string | null

                ý định tìm kiếm chính
                giá trị khả dụng: informational, navigational, commercial, transactional

              • se_type
                Kiểu: string | null

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

            • serp_info
              Kiểu: object | null · Response36Afe1097B20_SerpInfo

              dữ liệu SERP
              giá trị sẽ là null nếu bạn không đặt trường include_serp_info thành true trong mảng POST hoặc nếu không có dữ liệu SERP cho từ khóa này trong cơ sở dữ liệu của chúng tôi

              • check_url
                Kiểu: string | null

                URL trực tiếp đến kết quả công cụ tìm kiếm
                bạn có thể dùng URL này để đảm bảo chúng tôi đã cung cấp kết quả chính xác

              • last_updated_time
                Kiểu: string | null

                ngày và giờ cập nhật dữ liệu từ khóa
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ví dụ:
                2019-11-15 12:57:46 +00:00

              • previous_updated_time
                Kiểu: string | null

                thời điểm trước lần cập nhật dữ liệu SERP gần nhất
                theo định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                ví dụ:
                2019-10-15 12:57:46 +00:00

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

                số kết quả tìm kiếm cho từ khóa được trả về

              • se_type
                Kiểu: string | null

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

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

                các loại kết quả tìm kiếm trong SERP
                chứa các loại kết quả tìm kiếm (items) được tìm thấy trong SERP
                các loại mục khả dụng:
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                lưu ý rằng kết quả thực tế chỉ được trả về cho các phần tử organic, paid, featured_snippet, and local_pack

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

            số 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

          • offset
            Kiểu: integer | null

            giá trị offset hiện tại

          • offset_token
            Kiểu: string | null

            token offset cho các yêu cầu tiếp theo
            bạn có thể dùng chuỗi được cung cấp trong trường này để lấy các kết quả tiếp theo của tác vụ ban đầu;
            lưu ý: giá trị offset_token là duy nhất cho mỗi tác vụ tiếp theo

          • 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 trong một mảng POST
            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ả liên quan đến yêu cầu của bạn trong cơ sở dữ liệu của chúng tôi

        • 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/keyword_ideas/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_ideas/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone",
      "watch"
    ],
    "location_code": 2840,
    "language_code": "en",
    "include_serp_info": true,
    "limit": 3
  }
]'

{
  "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,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "se_type": null,
              "keyword": null,
              "location_code": null,
              "language_code": null,
              "keyword_info": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
              "clickstream_keyword_info": "[Max Depth Exceeded]",
              "keyword_properties": "[Max Depth Exceeded]",
              "serp_info": "[Max Depth Exceeded]",
              "avg_backlinks_info": "[Max Depth Exceeded]",
              "search_intent_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Keyword Ideas