App Store 应用竞品实时数据

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

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/live"

payload = {
    "app_id": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "language_name": "<string>",
    "language_code": "<string>",
    "filters": ["<string>"],
    "order_by": ["<string>"],
    "limit": 123,
    "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({
    app_id: '<string>',
    location_name: '<string>',
    location_code: 123,
    language_name: '<string>',
    language_code: '<string>',
    filters: ['<string>'],
    order_by: ['<string>'],
    limit: 123,
    offset: 123,
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/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/apple/app_competitors/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([
    'app_id' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'language_name' => '<string>',
    'language_code' => '<string>',
    'filters' => [
        '<string>'
    ],
    'order_by' => [
        '<string>'
    ],
    'limit' => 123,
    '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/apple/app_competitors/live"

	payload := strings.NewReader("{\n  \"app_id\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"limit\": 123,\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/apple/app_competitors/live")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"app_id\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"limit\": 123,\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/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  \"app_id\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"limit\": 123,\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.app_id": "<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.app_id": "<string>",
  "tasks.result.items.avg_position": 123,
  "tasks.result.items.sum_position": 123,
  "tasks.result.items.intersections": 123,
  "tasks.result.items.competitor_metrics": {},
  "tasks.result.items.competitor_metrics.app_store_search_organic": {},
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_1": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_2_3": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_4_10": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_11_100": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.count": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.search_volume": 123,
  "tasks.result.items.full_metrics": {},
  "tasks.result.items.full_metrics.app_store_search_organic": {},
  "tasks.result.items.full_metrics.app_store_search_organic.pos_1": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.pos_2_3": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.pos_4_10": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.pos_11_100": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.count": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.search_volume": 123
}

POST

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

dataforseo

dataforseo_labs

apple

app_competitors

live

App Store 应用竞品实时数据

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

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/live"

payload = {
    "app_id": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "language_name": "<string>",
    "language_code": "<string>",
    "filters": ["<string>"],
    "order_by": ["<string>"],
    "limit": 123,
    "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({
    app_id: '<string>',
    location_name: '<string>',
    location_code: 123,
    language_name: '<string>',
    language_code: '<string>',
    filters: ['<string>'],
    order_by: ['<string>'],
    limit: 123,
    offset: 123,
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/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/apple/app_competitors/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([
    'app_id' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'language_name' => '<string>',
    'language_code' => '<string>',
    'filters' => [
        '<string>'
    ],
    'order_by' => [
        '<string>'
    ],
    'limit' => 123,
    '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/apple/app_competitors/live"

	payload := strings.NewReader("{\n  \"app_id\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"limit\": 123,\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/apple/app_competitors/live")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"app_id\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"limit\": 123,\n  \"offset\": 123,\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/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  \"app_id\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"filters\": [\n    \"<string>\"\n  ],\n  \"order_by\": [\n    \"<string>\"\n  ],\n  \"limit\": 123,\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.app_id": "<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.app_id": "<string>",
  "tasks.result.items.avg_position": 123,
  "tasks.result.items.sum_position": 123,
  "tasks.result.items.intersections": 123,
  "tasks.result.items.competitor_metrics": {},
  "tasks.result.items.competitor_metrics.app_store_search_organic": {},
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_1": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_2_3": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_4_10": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.pos_11_100": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.count": 123,
  "tasks.result.items.competitor_metrics.app_store_search_organic.search_volume": 123,
  "tasks.result.items.full_metrics": {},
  "tasks.result.items.full_metrics.app_store_search_organic": {},
  "tasks.result.items.full_metrics.app_store_search_organic.pos_1": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.pos_2_3": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.pos_4_10": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.pos_11_100": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.count": 123,
  "tasks.result.items.full_metrics.app_store_search_organic.search_volume": 123
}

授权

Authorization

string

header

必填

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

请求体

application/json

app_id

string

必填

应用 id，必填字段。App Store 中移动应用的 ID；可在 App Store 所列每个应用的 URL 中找到该 ID；示例：在 URL https://apps.apple.com/us/app/id835599320 中，id 为 835599320

location_name

string

必填

位置的完整名称。如果未指定 location_code，则为必填字段。注意：必须指定 location_name 或 location_code 之一。您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发起请求，获取包含 location_name 的可用位置列表。注意：此端点目前仅支持美国位置。示例：United States

location_code

integer

必填

位置代码。如果未指定 location_name，则为必填字段。注意：必须指定 location_name 或 location_code 之一。您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求，获取包含 location_code 的可用位置列表；注意：此端点目前仅支持美国位置；示例：2840

language_name

string

必填

语言的完整名称。如果未指定 language_code，则此字段为必填字段。注意：必须指定 language_name 或 language_code 之一。可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发出请求，获取包含 language_name 的可用语言列表；注意：此端点目前仅支持英语；示例：English

language_code

string

必填

语言代码。如果未指定 language_name，则为必填字段。注意：必须指定 language_name 或 language_code 之一。您可以通过单独请求 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages，获取可用语言及其 language_code 的列表；注意：此端点目前仅支持英语。示例：en

filters

string[]

结果筛选参数数组。可选字段。你可以同时添加多个筛选条件（最多 8 个）。应在条件之间设置逻辑运算符 and、or。支持以下运算符：、、>、>=、=、、in、not_in。示例：["intersections",">",500] [["competitor_metrics.app_store_search_organic.pos_1","",10],"and",["avg_position",">=","10"]] [[["intersections",">=",50],"and",["competitor_metrics.app_store_search_organic.pos_1","in",[1,5]]], "or", ["sum_position",">=","10000"]]。有关筛选条件的更多信息，请参阅 Dataforseo Labs – Filters 或此帮助中心指南。

order_by

string[]

结果排序规则，可选字段；您可以使用与 filters 数组中相同的值对结果进行排序；可用的排序类型：asc – 结果将按升序排列；desc – 结果将按降序排列；应使用逗号指定排序类型；示例：["intersections,asc"] 注意：单个请求中最多可以设置三条排序规则；应使用逗号分隔多条排序规则；示例：["intersections,desc","sum_position,asc"] 默认规则：["intersections,desc"] 注意：如果 item_types 数组包含不同于 organic 的项目类型，结果将按数组中的第一个项目类型排序

limit

integer

返回应用的最大数量，可选字段，默认值：100，最大值：1000

offset

integer

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

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.app_id

string

POST 数组中的应用 id

tasks.result.location_code

integer

POST 数组中的位置代码

tasks.result.language_code

string

POST 数组中的语言代码

tasks.result.total_count

integer

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

tasks.result.items_count

integer

items 数组中返回的结果数量

tasks.result.items

string[]

包含与 app_id 和竞品应用相关的数据

tasks.result.items.se_type

string

搜索引擎类型

tasks.result.items.app_id

string

竞品应用的 id

tasks.result.items.avg_position

number

应用在 App Store SERP 中的平均排名；注意：平均排名仅根据交集关键词计算；同一应用与不同目标应用组合时，该值可能有所不同

tasks.result.items.sum_position

integer

应用在 App Store SERP 中所有排名的总和；注意：排名总和仅根据交集关键词计算；同一应用与不同目标应用组合时，该值可能有所不同

tasks.result.items.intersections

integer

相交关键词的数量

tasks.result.items.competitor_metrics

object

相交关键词的排名指标；与 POST 请求中所提供竞争对手应用和该应用共有的关键词相关的排名数据。注意：在此数组中，排名数据针对返回的竞争对手的 app_id 提供。

tasks.result.items.competitor_metrics.app_store_search_organic

object

来自 App Store 自然搜索的排名数据

tasks.result.items.competitor_metrics.app_store_search_organic.pos_1

integer

竞争对手应用在自然搜索结果中排名第 1 位的 SERP 数量

tasks.result.items.competitor_metrics.app_store_search_organic.pos_2_3

integer

竞争对手应用在自然搜索结果中排名第 2-3 位的 SERP 数量

tasks.result.items.competitor_metrics.app_store_search_organic.pos_4_10

integer

竞争对手应用在自然搜索结果中排名第 4-10 位的 SERP 数量

tasks.result.items.competitor_metrics.app_store_search_organic.pos_11_100

integer

竞争对手应用在自然搜索结果中排名第 11-100 位的 SERP 数量

tasks.result.items.competitor_metrics.app_store_search_organic.count

integer

包含竞争对手应用的自然搜索 SERP 总数

tasks.result.items.competitor_metrics.app_store_search_organic.search_volume

integer

App Store 自然搜索 SERP 中交集关键词的总搜索量

tasks.result.items.full_metrics

object

应用所有关键词的指标；全面概述所提供 app_id 参与排名的所有关键词的相关排名数据。

tasks.result.items.full_metrics.app_store_search_organic

object

来自 App Store 自然搜索的排名数据

tasks.result.items.full_metrics.app_store_search_organic.pos_1

integer

竞争对手应用在自然搜索结果中排名第 1 位的 SERP 数量

tasks.result.items.full_metrics.app_store_search_organic.pos_2_3

integer

竞争对手应用在自然搜索结果中排名第 2-3 位的 SERP 数量

tasks.result.items.full_metrics.app_store_search_organic.pos_4_10

integer

竞争对手应用在自然搜索结果中排名第 4-10 位的 SERP 数量

tasks.result.items.full_metrics.app_store_search_organic.pos_11_100

integer

竞争对手应用在自然搜索结果中排名第 11-100 位的 SERP 数量

tasks.result.items.full_metrics.app_store_search_organic.count

integer

包含竞争对手应用的自然搜索 SERP 总数

tasks.result.items.full_metrics.app_store_search_organic.search_volume

integer

应用在 App Store 自然搜索结果页中排名关键词的总搜索量

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

App Store 应用竞品实时数据

授权

请求体

响应