关键词排名

关键词排名

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "asin": "<string>",
  "location_name": "<string>",
  "location_code": 123,
  "language_name": "<string>",
  "language_code": "<string>",
  "limit": 123,
  "ignore_synonyms": true,
  "filters": [
    "<string>"
  ],
  "order_by": [
    "<string>"
  ],
  "offset": 123,
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live"

payload = {
    "asin": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "language_name": "<string>",
    "language_code": "<string>",
    "limit": 123,
    "ignore_synonyms": True,
    "filters": ["<string>"],
    "order_by": ["<string>"],
    "offset": 123,
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    asin: '<string>',
    location_name: '<string>',
    location_code: 123,
    language_name: '<string>',
    language_code: '<string>',
    limit: 123,
    ignore_synonyms: true,
    filters: ['<string>'],
    order_by: ['<string>'],
    offset: 123,
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'asin' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'language_name' => '<string>',
    'language_code' => '<string>',
    'limit' => 123,
    'ignore_synonyms' => true,
    'filters' => [
        '<string>'
    ],
    'order_by' => [
        '<string>'
    ],
    'offset' => 123,
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live"

	payload := strings.NewReader("{\n  \"asin\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"limit\": 123,\n  \"ignore_synonyms\": true,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"asin\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"limit\": 123,\n  \"ignore_synonyms\": true,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"asin\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"limit\": 123,\n  \"ignore_synonyms\": true,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "tasks.result": [
    "<string>"
  ],
  "tasks.result.se_type": "<string>",
  "tasks.result.asin": "<string>",
  "tasks.result.location_code": 123,
  "tasks.result.language_code": "<string>",
  "tasks.result.total_count": 123,
  "tasks.result.items_count": 123,
  "tasks.result.items": [
    "<string>"
  ],
  "tasks.result.items.se_type": "<string>",
  "tasks.result.items.keyword_data": {},
  "tasks.result.items.keyword_data.se_type": "<string>",
  "tasks.result.items.keyword_data.keyword": "<string>",
  "tasks.result.items.keyword_data.location_code": 123,
  "tasks.result.items.keyword_data.language_code": "<string>",
  "tasks.result.items.keyword_data.keyword_info": {},
  "tasks.result.items.keyword_data.keyword_info.se_type": "<string>",
  "tasks.result.items.keyword_data.keyword_info.last_updated_time": "<string>",
  "tasks.result.items.keyword_data.keyword_info.search_volume": 123,
  "tasks.result.items.ranked_serp_element": {},
  "tasks.result.items.ranked_serp_element.se_type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item": {},
  "tasks.result.items.ranked_serp_element.serp_item.se_type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.rank_group": 123,
  "tasks.result.items.ranked_serp_element.serp_item.rank_absolute": 123,
  "tasks.result.items.ranked_serp_element.serp_item.position": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.xpath": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.domain": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.title": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.url": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.description": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.asin": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.image_url": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.price_from": 123,
  "tasks.result.items.ranked_serp_element.serp_item.price_to": 123,
  "tasks.result.items.ranked_serp_element.serp_item.currency": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.special_offers": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.serp_item.is_best_seller": true,
  "tasks.result.items.ranked_serp_element.serp_item.is_amazon_choice": true,
  "tasks.result.items.ranked_serp_element.serp_item.rating": {},
  "tasks.result.items.ranked_serp_element.serp_item.rating.rating_type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.rating.value": 123,
  "tasks.result.items.ranked_serp_element.serp_item.rating.votes_count": 123,
  "tasks.result.items.ranked_serp_element.serp_item.rating.rating_max": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info": {},
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_message": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price": {},
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.current": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.regular": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.max_value": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.currency": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.is_price_range": true,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.displayed_price": "<string>",
  "tasks.result.items.ranked_serp_element.check_url": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item_types": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.se_results_count": 123,
  "tasks.result.items.ranked_serp_element.last_updated_time": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.se_type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.rank_group": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rank_absolute": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.position": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.xpath": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.domain": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.title": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.url": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.description": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.asin": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.image_url": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.price_from": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.price_to": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.currency": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.special_offers": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.previous_updated_time.is_best_seller": true,
  "tasks.result.items.ranked_serp_element.previous_updated_time.is_amazon_choice": true,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating": {},
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.value": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.votes_count": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_max": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info": {},
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_message": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price": {},
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.current": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.regular": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.max_value": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.currency": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.is_price_range": true,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.displayed_price": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.title": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.url": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.image_alt": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.image_url": "<string>"
}

POST

https://api.aisa.one/apis/v1

dataforseo

dataforseo_labs

amazon

ranked_keywords

live

关键词排名

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "asin": "<string>",
  "location_name": "<string>",
  "location_code": 123,
  "language_name": "<string>",
  "language_code": "<string>",
  "limit": 123,
  "ignore_synonyms": true,
  "filters": [
    "<string>"
  ],
  "order_by": [
    "<string>"
  ],
  "offset": 123,
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live"

payload = {
    "asin": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "language_name": "<string>",
    "language_code": "<string>",
    "limit": 123,
    "ignore_synonyms": True,
    "filters": ["<string>"],
    "order_by": ["<string>"],
    "offset": 123,
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    asin: '<string>',
    location_name: '<string>',
    location_code: 123,
    language_name: '<string>',
    language_code: '<string>',
    limit: 123,
    ignore_synonyms: true,
    filters: ['<string>'],
    order_by: ['<string>'],
    offset: 123,
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'asin' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'language_name' => '<string>',
    'language_code' => '<string>',
    'limit' => 123,
    'ignore_synonyms' => true,
    'filters' => [
        '<string>'
    ],
    'order_by' => [
        '<string>'
    ],
    'offset' => 123,
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live"

	payload := strings.NewReader("{\n  \"asin\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"limit\": 123,\n  \"ignore_synonyms\": true,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"asin\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"limit\": 123,\n  \"ignore_synonyms\": true,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"asin\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"limit\": 123,\n  \"ignore_synonyms\": true,\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "tasks.result": [
    "<string>"
  ],
  "tasks.result.se_type": "<string>",
  "tasks.result.asin": "<string>",
  "tasks.result.location_code": 123,
  "tasks.result.language_code": "<string>",
  "tasks.result.total_count": 123,
  "tasks.result.items_count": 123,
  "tasks.result.items": [
    "<string>"
  ],
  "tasks.result.items.se_type": "<string>",
  "tasks.result.items.keyword_data": {},
  "tasks.result.items.keyword_data.se_type": "<string>",
  "tasks.result.items.keyword_data.keyword": "<string>",
  "tasks.result.items.keyword_data.location_code": 123,
  "tasks.result.items.keyword_data.language_code": "<string>",
  "tasks.result.items.keyword_data.keyword_info": {},
  "tasks.result.items.keyword_data.keyword_info.se_type": "<string>",
  "tasks.result.items.keyword_data.keyword_info.last_updated_time": "<string>",
  "tasks.result.items.keyword_data.keyword_info.search_volume": 123,
  "tasks.result.items.ranked_serp_element": {},
  "tasks.result.items.ranked_serp_element.se_type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item": {},
  "tasks.result.items.ranked_serp_element.serp_item.se_type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.rank_group": 123,
  "tasks.result.items.ranked_serp_element.serp_item.rank_absolute": 123,
  "tasks.result.items.ranked_serp_element.serp_item.position": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.xpath": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.domain": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.title": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.url": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.description": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.asin": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.image_url": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.price_from": 123,
  "tasks.result.items.ranked_serp_element.serp_item.price_to": 123,
  "tasks.result.items.ranked_serp_element.serp_item.currency": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.special_offers": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.serp_item.is_best_seller": true,
  "tasks.result.items.ranked_serp_element.serp_item.is_amazon_choice": true,
  "tasks.result.items.ranked_serp_element.serp_item.rating": {},
  "tasks.result.items.ranked_serp_element.serp_item.rating.rating_type": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.rating.value": 123,
  "tasks.result.items.ranked_serp_element.serp_item.rating.votes_count": 123,
  "tasks.result.items.ranked_serp_element.serp_item.rating.rating_max": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info": {},
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_message": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price": {},
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.current": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.regular": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.max_value": 123,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.currency": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.is_price_range": true,
  "tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.displayed_price": "<string>",
  "tasks.result.items.ranked_serp_element.check_url": "<string>",
  "tasks.result.items.ranked_serp_element.serp_item_types": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.se_results_count": 123,
  "tasks.result.items.ranked_serp_element.last_updated_time": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.se_type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.rank_group": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rank_absolute": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.position": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.xpath": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.domain": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.title": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.url": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.description": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.asin": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.image_url": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.price_from": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.price_to": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.currency": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.special_offers": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.previous_updated_time.is_best_seller": true,
  "tasks.result.items.ranked_serp_element.previous_updated_time.is_amazon_choice": true,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating": {},
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.value": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.votes_count": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_max": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info": {},
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_message": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price": {},
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.current": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.regular": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.max_value": 123,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.currency": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.is_price_range": true,
  "tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.displayed_price": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items": [
    "<string>"
  ],
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.type": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.title": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.url": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.image_alt": "<string>",
  "tasks.result.items.ranked_serp_element.previous_updated_time.items.image_url": "<string>"
}

此端点将提供目标产品在 Amazon 上获得排名的关键词列表。返回的结果特定于 POST 请求中指定的 asin。有关 ASIN 的更多信息，请参阅此帮助中心文章。

示例

curl -X POST "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[{"asin": "...", "location_name": "...", "location_code": "..."}]'

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

asin

string

必填

产品 ID 必填字段 Amazon 上的唯一产品标识符（ASIN）；您可以通过单独请求 Amazon Products 端点获取 asin 参数

location_name

string

必填

位置的完整名称。如果未指定 location_code，则为必填字段。可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求，获取包含 location_name 的可用位置列表。注意：此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国的位置。示例：United States

location_code

integer

必填

位置代码；如果未指定 location_name，则为必填字段；您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发出请求，获取可用位置及其 location_code 的列表；注意：此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国的位置；示例：2840

language_name

string

必填

语言全名必填字段如果未指定 language_code，可以向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求，以获取可用语言及其 language_name 的列表示例：English

language_code

string

必填

语言代码；如果未指定 language_name，则为必填字段；可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发起请求，获取可用语言及其 language_code 列表；示例：en

limit

integer

结果数组中的最大产品数量，可选字段，默认值：100；最大值：1000

ignore_synonyms

boolean

忽略高度相似的关键词，可选字段。如果设置为 true，则仅返回核心关键词，并排除所有高度相似的关键词；默认值：false

filters

string[]

结果过滤参数数组可选字段可以同时添加多个过滤器（最多 8 个过滤器）应在条件之间设置逻辑运算符 and、or 支持以下运算符：regex、not_regex、,、,、>、>=、=、,、in、not_in、like、not_like、match、not_match 可以将 % 运算符与 like 和 not_like 配合使用，以匹配由零个或多个字符组成的任意字符串示例：["keyword_data.keyword_info.search_volume","in",[100,1000]]；有关过滤器的更多信息，请参阅 Dataforseo Labs – Filters 或此帮助中心指南

order_by

string[]

结果排序规则，可选字段。你可以使用与 filters 数组中相同的值对结果进行排序。可用排序类型：asc – 结果将按升序排列；desc – 结果将按降序排列。应使用逗号设置排序参数。示例：["keyword_data.keyword_info.competition,desc"]。默认规则：["ranked_serp_element.serp_item.rank_group,asc"]。请注意，单个请求最多可以设置三个排序规则。应使用逗号分隔多个排序规则。示例：["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"]

offset

integer

返回关键词的结果数组中的偏移量，可选字段，默认值：0。如果指定值 10，结果数组中的前十个关键词将被省略，并提供后续关键词的数据

tag

string

用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值

响应

成功响应

version

string

API 的当前版本

status_code

integer

通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况

status_message

string

常规信息消息；可在此处查看常规信息消息的完整列表

time

string

执行时间（秒）

cost

number

任务总成本（美元）

tasks_count

integer

tasks 数组中的任务数量

tasks_error

integer

返回错误的 tasks 数组中的任务数量

tasks

string[]

任务数组

tasks.id

string

任务标识符，系统中采用 UUID 格式的唯一任务标识符

tasks.status_code

integer

DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看

tasks.status_message

string

任务的信息性消息，你可以在此处查看通用信息性消息的完整列表

tasks.time

string

执行时间（秒）

tasks.cost

number

任务成本（美元）

tasks.result_count

integer

结果数组中的元素数量

tasks.path

string[]

URL 路径

tasks.data

object

包含您在 POST 请求中指定的相同参数

tasks.result

string[]

结果数组

tasks.result.se_type

string

搜索引擎类型

tasks.result.asin

string

POST 数组中的 ASIN

tasks.result.location_code

integer

POST 数组中的位置代码；如果没有数据，则值为 null

tasks.result.language_code

string

POST 数组中的语言代码；如果没有数据，则值为 null

tasks.result.total_count

integer

数据库中与您的请求相关的结果总量

tasks.result.items_count

integer

items 数组中返回的结果数量

tasks.result.items

string[]

包含检测到的 Amazon 产品竞争对手及相关数据

tasks.result.items.se_type

string

搜索引擎类型

tasks.result.items.keyword_data

object

返回关键词的关键词数据

tasks.result.items.keyword_data.se_type

string

搜索引擎类型

tasks.result.items.keyword_data.keyword

string

返回的关键词

tasks.result.items.keyword_data.location_code

integer

POST 数组中的位置代码

tasks.result.items.keyword_data.language_code

string

POST 数组中的语言代码

tasks.result.items.keyword_data.keyword_info

object

返回关键词的关键词信息

tasks.result.items.keyword_data.keyword_info.se_type

string

搜索引擎类型

tasks.result.items.keyword_data.keyword_info.last_updated_time

string

keyword 数据更新的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：2019-11-15 12:57:46 +00:00

tasks.result.items.keyword_data.keyword_info.search_volume

integer

平均每月搜索量，表示返回的关键词在 Amazon 上的（近似）搜索次数

tasks.result.items.ranked_serp_element

object

包含为返回的关键词找到的产品 SERP 元素相关数据

tasks.result.items.ranked_serp_element.se_type

string

搜索引擎类型

tasks.result.items.ranked_serp_element.serp_item

object

包含 SERP 元素的数据，支持的 SERP 元素列表见下文

tasks.result.items.ranked_serp_element.serp_item.se_type

string

搜索引擎类型

tasks.result.items.ranked_serp_element.serp_item.type

string

元素类型 = ‘amazon_serp’

tasks.result.items.ranked_serp_element.serp_item.rank_group

integer

在 type 值相同的元素组内的位置；type 值不同的元素位置不会计入 rank_group。

tasks.result.items.ranked_serp_element.serp_item.rank_absolute

integer

Amazon SERP 中的绝对排名，即在 SERP 所有元素中的绝对位置

tasks.result.items.ranked_serp_element.serp_item.position

string

元素在 Amazon SERP 中的对齐方式可取以下值：left、right

tasks.result.items.ranked_serp_element.serp_item.xpath

string

元素的 XPath

tasks.result.items.ranked_serp_element.serp_item.domain

string

Amazon 域名

tasks.result.items.ranked_serp_element.serp_item.title

string

产品标题

tasks.result.items.ranked_serp_element.serp_item.url

string

产品页面的 URL

tasks.result.items.ranked_serp_element.serp_item.description

string

产品描述

tasks.result.items.ranked_serp_element.serp_item.asin

string

产品的 ASIN；有关 ASIN 的更多信息，请参阅此帮助中心指南

tasks.result.items.ranked_serp_element.serp_item.image_url

string

结果中展示的产品图片 URL

tasks.result.items.ranked_serp_element.serp_item.price_from

number

产品的常规价格，例如：49.98

tasks.result.items.ranked_serp_element.serp_item.price_to

number

产品价格范围的上限，示例：384.99

tasks.result.items.ranked_serp_element.serp_item.currency

string

ISO 格式的货币，例如：USD

tasks.result.items.ranked_serp_element.serp_item.special_offers

string[]

特别优惠详情，包含优惠券和 Subscribe & Save 折扣等特别优惠信息

tasks.result.items.ranked_serp_element.serp_item.is_best_seller

boolean

“Best Seller”标签；如果值为 true，则产品会被标记为“Best Seller”

tasks.result.items.ranked_serp_element.serp_item.is_amazon_choice

boolean

“Amazon’s choice”标签，如果值为 true，则产品会标有“Amazon’s choice”标签

tasks.result.items.ranked_serp_element.serp_item.rating

object

该条目的评分，即基于评论得出的热度评分，并显示在 SERP 中

tasks.result.items.ranked_serp_element.serp_item.rating.rating_type

string

评分类型；可使用以下值：Max5、Percents、CustomMax

tasks.result.items.ranked_serp_element.serp_item.rating.value

integer

评级值

tasks.result.items.ranked_serp_element.serp_item.rating.votes_count

integer

反馈数量

tasks.result.items.ranked_serp_element.serp_item.rating.rating_max

integer

rating_type 的最大值

tasks.result.items.ranked_serp_element.serp_item.delivery_info

object

配送信息，包括免费配送和快速配送的日期范围

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_message

string

配送信息；卖家发布的配送信息所附消息

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price

object

配送价格根据你在 POST 请求中指定的位置计算的配送价格；如果提供免费配送，则值为 null

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.current

number

当前交割价格

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.regular

number

常规未折扣配送价格

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.max_value

number

未折现最高交割价格

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.currency

string

ISO 格式的货币代码

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.is_price_range

boolean

指示配送价格是否为区间

tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.displayed_price

string

Amazon 商品信息中显示的价格行

tasks.result.items.ranked_serp_element.check_url

string

Amazon 结果的直接 URL，您可以使用该 URL 确认我们提供的结果准确无误

tasks.result.items.ranked_serp_element.serp_item_types

string[]

Amazon 结果的直接 URL；包含返回的 SERP 中找到的所有搜索结果（项目）类型；可能的项目类型：amazon_serp、amazon_paid、editorial_recommendations、top_rated_from_our_brands、related_searches

tasks.result.items.ranked_serp_element.se_results_count

integer

Amazon SERP 中的结果总数

tasks.result.items.ranked_serp_element.last_updated_time

string

SERP 数据最后更新的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：2019-11-15 12:57:46 +00:00

tasks.result.items.ranked_serp_element.previous_updated_time

string

SERP 数据最近一次更新的前一次更新时间，采用 ISO 8601 格式：“YYYY-MM-DDThh:mm:ss.sssssssZ” 示例：2020-09-12T00:07:43.0733218Z

tasks.result.items.ranked_serp_element.previous_updated_time.se_type

string

搜索引擎类型

tasks.result.items.ranked_serp_element.previous_updated_time.type

string

元素类型 = ‘related_searches’

tasks.result.items.ranked_serp_element.previous_updated_time.rank_group

integer

在 type 值相同的元素组内的位置；type 值不同的元素位置不会计入 rank_group。

tasks.result.items.ranked_serp_element.previous_updated_time.rank_absolute

integer

Amazon SERP 中的绝对排名，即在 SERP 所有元素中的绝对位置

tasks.result.items.ranked_serp_element.previous_updated_time.position

string

元素在 Amazon SERP 中的对齐方式可取以下值：left、right

tasks.result.items.ranked_serp_element.previous_updated_time.xpath

string

元素的 XPath

tasks.result.items.ranked_serp_element.previous_updated_time.domain

string

Amazon 域名

tasks.result.items.ranked_serp_element.previous_updated_time.title

string

产品标题

tasks.result.items.ranked_serp_element.previous_updated_time.url

string

产品页面的 URL

tasks.result.items.ranked_serp_element.previous_updated_time.description

string

产品描述

tasks.result.items.ranked_serp_element.previous_updated_time.asin

string

产品的 ASIN；有关 ASIN 的更多信息，请参阅此帮助中心指南

tasks.result.items.ranked_serp_element.previous_updated_time.image_url

string

结果中展示的产品图片 URL

tasks.result.items.ranked_serp_element.previous_updated_time.price_from

number

产品的常规价格，例如：49.98

tasks.result.items.ranked_serp_element.previous_updated_time.price_to

number

产品价格范围的上限，示例：384.99

tasks.result.items.ranked_serp_element.previous_updated_time.currency

string

ISO 格式的货币，例如：USD

tasks.result.items.ranked_serp_element.previous_updated_time.special_offers

string[]

特别优惠详情，包含优惠券和 Subscribe & Save 折扣等特别优惠信息

tasks.result.items.ranked_serp_element.previous_updated_time.is_best_seller

boolean

“Best Seller”标签；如果值为 true，则产品会被标记为“Best Seller”

tasks.result.items.ranked_serp_element.previous_updated_time.is_amazon_choice

boolean

“Amazon’s choice”标签，如果值为 true，则产品会标有“Amazon’s choice”标签

tasks.result.items.ranked_serp_element.previous_updated_time.rating

object

该条目的评分，即基于评论得出的热度评分，并显示在 SERP 中

tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_type

string

评分类型；可使用以下值：Max5、Percents、CustomMax

tasks.result.items.ranked_serp_element.previous_updated_time.rating.value

integer

评级值

tasks.result.items.ranked_serp_element.previous_updated_time.rating.votes_count

integer

反馈数量

tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_max

integer

rating_type 的最大值

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info

object

配送信息，包括免费配送和快速配送的日期范围

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_message

string

配送信息；卖家发布的配送信息所附消息

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price

object

配送价格根据你在 POST 请求中指定的位置计算的配送价格；如果提供免费配送，则值为 null

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.current

number

当前交割价格

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.regular

number

常规未折扣配送价格

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.max_value

number

未折现最高交割价格

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.currency

string

ISO 格式的货币代码

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.is_price_range

boolean

指示配送价格是否为区间

tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.displayed_price

string

Amazon 商品信息中显示的价格行

tasks.result.items.ranked_serp_element.previous_updated_time.items

string[]

包含

tasks.result.items.ranked_serp_element.previous_updated_time.items.type

string

元素类型 = ‘related_searches_element’

tasks.result.items.ranked_serp_element.previous_updated_time.items.title

string

产品标题

tasks.result.items.ranked_serp_element.previous_updated_time.items.url

string

产品页面的 URL

tasks.result.items.ranked_serp_element.previous_updated_time.items.image_alt

string

结果中展示的产品图片的 alt 标签

tasks.result.items.ranked_serp_element.previous_updated_time.items.image_url

string

结果中展示的产品图片 URL

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

示例

授权

请求体

响应

​示例

授权

请求体

响应

示例