v0.2.0-beta

OpenAPI 3.1.0

Đối thủ ứng dụng App Store trực tiếp

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

post/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live

Đối thủ ứng dụng App Store trực tiếp

Ứng dụng App Store cạnh tranh với một ứng dụng nhất định trên các từ khóa chung. 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. Bản tương ứng trên Google Play: post_dataforseo_labs_google_app_competitors_live.

Tham chiếu giá

Cách tính: chi phí phản hồi được báo cáo.
Ước tính tham chiếu mỗi yêu cầu: 0,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)[]
- app_id
  Kiểu: string
  
  id của ứng dụng
  trường bắt buộc
  ID của ứng dụng di động trên App Store;
  bạn có thể tìm thấy ID trong URL của mọi ứng dụng được liệt kê trên App Store;
  ví dụ:
  trong URL https://apps.apple.com/us/app/id835599320
  id là 835599320
- 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ợ:
  <, <=, >, >=, =, <>, in, not_in
  ví dụ:
  ["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"]]
  
  để 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
- 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
  Lưu ý: cần chỉ định language_name hoặc language_code
  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;
  Lưu ý: endpoint này hiện chỉ hỗ trợ ngôn ngữ English
  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
  Lưu ý: cần chỉ định language_name hoặc 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;
  Lưu ý: endpoint này hiện chỉ hỗ trợ ngôn ngữ English;
  ví dụ:
  English
- limit
  Kiểu: integer | null
  
  số ứng dụng trả về tối đa
  trường tùy chọn
  giá trị mặc định: 100
  giá trị tối đa: 1000
- location_code
  Kiểu: integer
  
  mã vị trí
  trường bắt buộc nếu bạn không chỉ định location_name
  Lưu ý: cần chỉ định location_name hoặc location_code
  bạn có thể nhận danh sách vị trí khả dụng cùng location_code của chúng bằng cách gửi một yêu cầu riêng đến
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Lưu ý: endpoint này hiện chỉ hỗ trợ vị trí US
  ví dụ:
  2840
- location_name
  Kiểu: string
  
  tên đầy đủ của vị trí
  trường bắt buộc nếu bạn không chỉ định location_code
  Lưu ý: cần chỉ định location_name hoặc location_code
  bạn có thể nhận danh sách vị trí khả dụng cùng location_name của chúng bằng cách gửi một yêu cầu riêng đến
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Lưu ý: endpoint này hiện chỉ hỗ trợ vị trí US;
  ví dụ:
  United States
- offset
  Kiểu: integer | null
  
  độ lệch trong mảng kết quả của các ứng dụng 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 ứng dụng đầ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 ứng dụng 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 để chỉ định kiểu sắp xếp;
  ví dụ:
  ["intersections,asc"]
  Lưu ý: bạn có thể đặt không quá ba quy tắc sắp xếp trong một yêu cầu;
  bạn nên dùng dấu phẩy để phân tách nhiều quy tắc sắp xếp;
  ví dụ:
  ["intersections,desc","sum_position,asc"]
  
  quy tắc mặc định:
  ["intersections,desc"]
  Lưu ý: nếu mảng item_types chứa các loại mục khác với organic, kết quả sẽ được sắp xếp theo loại mục đầu tiên trong mảng
- tag
  Kiểu: string | null
  
  mã định danh tác vụ do người dùng xác định
  trường tùy chọn
  giới hạn ký tự là 255
  bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả
  bạn sẽ thấy giá trị tag đã chỉ định trong đối tượng data của phản hồi

Phản hồi

200
Kiểu: object | null · Response36Afe1097B20_DataforseoLabsAppleAppCompetitorsLiveResponseInfo
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_DataforseoLabsAppleAppCompetitorsLiveTaskInfo
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ả

app_id
Kiểu: string | null

id của ứng dụng trong mảng POST

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

chứa dữ liệu liên quan đến app_id và các ứng dụng đối thủ

app_id
Kiểu: string | null

id của ứng dụng trong mảng POST

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

vị trí trung bình của ứng dụng trong SERP Google Play
Lưu ý: vị trí trung bình chỉ được tính cho các từ khóa giao nhau;
giá trị của một ứng dụng nhất định có thể khác khi kết hợp với các ứng dụng mục tiêu khác nhau

competitor_metrics
Kiểu: object | null

chỉ số cho các từ khóa giao nhau
dữ liệu xếp hạng liên quan đến các từ khóa mà ứng dụng đối thủ được cung cấp chia sẻ với ứng dụng trong yêu cầu POST;
lưu ý: trong mảng này, dữ liệu xếp hạng được cung cấp cho app_id của đối thủ được trả về

propertyName
Kiểu: object · Response36Afe1097B20_AppMetricsInfo
count
Kiểu: integer | null Định dạng: int64

tổng số SERP organic của Amazon có chứa sản phẩm

pos_1
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #1

pos_11_100
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #11-100

pos_2_3
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #2-3

pos_4_10
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #4-10

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

tổng khối lượng tìm kiếm của các từ khóa xếp hạng của sản phẩm trong SERP organic

full_metrics
Kiểu: object | null

chỉ số cho tất cả từ khóa của ứng dụng
tổng quan đầy đủ về dữ liệu xếp hạng liên quan đến tất cả từ khóa mà app_id được cung cấp đang xếp hạng

propertyName
Kiểu: object · Response36Afe1097B20_AppMetricsInfo
count
Kiểu: integer | null Định dạng: int64

tổng số SERP organic của Amazon có chứa sản phẩm

pos_1
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #1

pos_11_100
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #11-100

pos_2_3
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #2-3

pos_4_10
Kiểu: integer | null

số SERP organic nơi sản phẩm xếp hạng #4-10

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

tổng khối lượng tìm kiếm của các từ khóa xếp hạng của sản phẩm trong SERP organic

intersections
Kiểu: integer | null

số từ khóa giao nhau

se_type
Kiểu: string | null

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

sum_position
Kiểu: integer | null

tổng tất cả vị trí của ứng dụng trong SERP Google Play
Lưu ý: vị trí tổng được tính cho các từ khóa giao nhau;
giá trị của một ứng dụng nhất định có thể khác khi kết hợp với các ứng dụng mục tiêu khác nhau

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

số lượng kết quả được trả về trong mảng items

language_code
Kiểu: string | null

mã ngôn ngữ trong mảng POST

location_code
Kiểu: integer | null

mã vị trí trong mảng POST

se_type
Kiểu: string | null

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

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

post/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "686449807",
    "language_name": "English",
    "location_code": 2840,
    "limit": 10
  }
]'

Hiện schema

{
  "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,
          "app_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Thao tác thành công

Đối thủ ứng dụng App Store trực tiếp

Xác thựcRequired

DataForSEO

Đối thủ ứng dụng App Store trực tiếp

Tham chiếu giá