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

Từ khóa được xếp hạng

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ừ khóa được xếp hạng

​

Các cụm từ tìm kiếm Amazon mà một sản phẩm xếp hạng. 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. Đây là chỉ mục Amazon riêng của Labs, nên phân trang và trả lời ngay - khác với seo-merchant, vốn xếp hàng một lượt scrape trực tiếp cửa hàng.

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)[]
    • asin
      Kiểu: string

      ID sản phẩm
      trường bắt buộc
      mã định danh sản phẩm duy nhất (ASIN) trên Amazon;
      bạn có thể nhận tham số asin bằng cách gửi một yêu cầu riêng đến endpoint Amazon Products

    • 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, like, not_like, match, not_match
      bạn có thể dùng toán tử % với like và not_like để khớp mọi chuỗi có 0 hoặc nhiều ký tự
      ví dụ:
      ["keyword_data.keyword_info.search_volume","in",[100,1000]];

      để 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

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

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

    • limit
      Kiểu: integer | null

      số sản phẩm tối đa trong mảng kết quả
      trường tùy chọn
      giá trị mặc định: 100;
      giá trị tối đa: 1000

    • location_code
      Kiểu: integer

      mã vị trí
      trường bắt buộc nếu bạn không 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;
      Lưu ý: endpoint này hiện chỉ hỗ trợ các vị trí US, Egypt, Saudi Arabia và United Arab Emirates;
      ví dụ:
      2840

    • location_name
      Kiểu: string

      tên đầy đủ của vị trí
      trường bắt buộc nếu không 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;
      Lưu ý: endpoint này hiện chỉ hỗ trợ các vị trí US, Egypt, Saudi Arabia và United Arab Emirates;
      ví dụ:
      United States

    • 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ả sẽ được sắp xếp theo thứ tự tăng dần
      desc - kết quả sẽ đượ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
      ví dụ:
      ["keyword_data.keyword_info.competition,desc"]
      quy tắc mặc định:
      ["ranked_serp_element.serp_item.rank_group,asc"]
      lưu ý rằng 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ụ:
      ["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,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_DataforseoLabsAmazonRankedKeywordsLiveResponseInfo
    • 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_DataforseoLabsAmazonRankedKeywordsLiveTaskInfo
        • 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ả

          • asin
            Kiểu: string | null

            ASIN trong một mảng POST

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

            chứa các đối thủ cạnh tranh sản phẩm Amazon được phát hiện và dữ liệu liên quan

            • keyword_data
              Kiểu: object | null · Response36Afe1097B20_KeywordDataInfo

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

              • 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

            • ranked_serp_element
              Kiểu: object | null · Response36Afe1097B20_AmazonRankedSerpElement

              chứa dữ liệu về phần tử SERP của sản phẩm được tìm thấy cho keyword được trả về

              • check_url
                Kiểu: string | null

                URL trực tiếp đến kết quả Amazon
                bạn có thể dùng URL này để đảm bảo rằng 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ờ dữ liệu từ khóa được cập nhật
                ở đị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

                trước lần cập nhật dữ liệu SERP gần nhất
                ở định dạng ISO 8601: “YYYY-MM-DDThh:mm:ss.sssssssZ”
                ví dụ:
                2020-09-12T00:07:43.0733218Z

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

                tổng số kết quả trong SERP Amazon

              • se_type
                Kiểu: string | null

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

              • serp_item
                Kiểu: object | null · Response36Afe1097B20_AmazonInfo

                chứa dữ liệu về phần tử SERP
                danh sách các phần tử SERP được hỗ trợ có thể xem bên dưới

                • asin
                  Kiểu: string | null

                  ASIN trong một mảng POST

                • bought_past_month
                  Kiểu: integer | null

                  Integer numbers.

                • currency
                  Kiểu: string | null

                  đơn vị tiền tệ theo định dạng ISO
                  ví dụ:
                  USD

                • delivery_info
                  Kiểu: object | null · Response36Afe1097B20_AmazonDeliveryInfo

                  thông tin giao hàng
                  thông tin giao hàng bao gồm khoảng ngày giao hàng miễn phí và nhanh

                  • delivery_date_from
                    Kiểu: string | null

                    ngày sớm nhất sản phẩm có thể được vận chuyển

                  • delivery_date_to
                    Kiểu: string | null

                    ngày muộn nhất sản phẩm có thể được giao

                  • delivery_message
                    Kiểu: string | null

                    thông điệp đi kèm thông tin giao hàng do người bán đăng

                  • delivery_price
                    Kiểu: object | null · Response36Afe1097B20_PriceInfo

                    giá giao hàng giá giao hàng dựa trên vị trí bạn đã chỉ định trong yêu cầu POST; nếu có giao hàng miễn phí, giá trị là null

                    • currency
                      Kiểu: string | null

                      loại tiền của giá được niêm yết mã ISO của loại tiền áp dụng cho giá

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

                      giá hiện tại cho biết giá hiện tại của sản phẩm hoặc dịch vụ trong kết quả

                    • displayed_price
                      Kiểu: string | null

                      chuỗi giá trong kết quả chuỗi giá thô như được cung cấp trong kết quả

                    • is_price_range
                      Kiểu: boolean | null

                      giá được cung cấp dưới dạng khoảng cho biết giá có được cung cấp dưới dạng khoảng hay không

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

                      giá tối đa giá tối đa của sản phẩm hoặc dịch vụ như được nêu trong kết quả

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

                      giá thường giá thường của sản phẩm hoặc dịch vụ khi không áp dụng giảm giá

                  • fastest_delivery_date_from
                    Kiểu: string | null

                    ngày sớm nhất sản phẩm có thể được giao với tùy chọn giao nhanh

                  • fastest_delivery_date_to
                    Kiểu: string | null

                    ngày muộn nhất sản phẩm có thể được giao với tùy chọn giao nhanh

                • domain
                  Kiểu: string | null

                  tên miền Amazon

                • image_url
                  Kiểu: string | null

                  URL của hình ảnh sản phẩm được hiển thị trong kết quả

                • is_amazon_choice
                  Kiểu: boolean | null

                  nhãn "Amazon's choice"
                  nếu giá trị là true, sản phẩm được gắn nhãn "Amazon's choice"

                • is_best_seller
                  Kiểu: boolean | null

                  nhãn "Best Seller"
                  nếu giá trị là true, sản phẩm được gắn nhãn "Best Seller"

                • position
                  Kiểu: string | null

                  căn chỉnh của phần tử trong SERP Amazon
                  có thể nhận các giá trị sau:
                  left, right

                • price_from
                  Kiểu: number | null

                  giá thông thường của sản phẩm
                  ví dụ:
                  49.98

                • price_to
                  Kiểu: number | null

                  giới hạn trên của khoảng giá sản phẩm
                  ví dụ:
                  384.99

                • rank_absolute
                  Kiểu: integer | null

                  thứ hạng tuyệt đối trong SERP Amazon
                  vị trí tuyệt đối trong tất cả các phần tử của SERP

                • rank_group
                  Kiểu: integer | null

                  vị trí trong một nhóm phần tử có cùng giá trị type
                  vị trí của các phần tử có giá trị type khác nhau bị bỏ khỏi rank_group

                • rating
                  Kiểu: object | null · Response36Afe1097B20_RatingInfo

                  xếp hạng của mục
                  mức độ phổ biến dựa trên đánh giá và được hiển thị trong SERP

                  • rating_max
                    Kiểu: integer | null

                    giá trị tối đa cho một rating_type

                  • rating_type
                    Kiểu: string | null

                    loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax

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

                    giá trị của xếp hạng

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

                    số lượng phản hồi

                • se_type
                  Kiểu: string | null

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

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

                  chi tiết ưu đãi đặc biệt
                  chứa chi tiết ưu đãi đặc biệt, bao gồm giảm giá coupon và Subscribe & Save

                • title
                  Kiểu: string | null

                  tiêu đề sản phẩm

                • type
                  Kiểu: string | null

                  loại phần tử

                • url
                  Kiểu: string | null

                  URL của trang sản phẩm

                • xpath
                  Kiểu: string | null

                  XPath của phần tử

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

                URL trực tiếp đến kết quả Amazon
                chứa các loại của tất cả kết quả tìm kiếm (items) được tìm thấy trong SERP được trả về;
                các loại mục khả dụng:
                amazon_serp, amazon_paid, editorial_recommendations, top_rated_from_our_brands, related_searches

            • 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ột mảng POST
            nếu không có dữ liệu, giá trị là null

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

          • se_type
            Kiểu: string | null

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

          • 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/amazon/ranked_keywords/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/amazon/ranked_keywords/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "asin": "B00R92CL5E",
    "location_code": 2840,
    "language_code": "en"
  }
]'

{
  "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,
          "asin": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": "[Max Depth Exceeded]",
              "ranked_serp_element": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Ranked Keywords