v0.2.0-beta

OpenAPI 3.1.0

Ambil hasil Apple App Reviews berdasarkan id

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operasi

get/v1/beta/dataforseo/app_data/apple/app_reviews/task_get/advanced/{id}

Ambil hasil Apple App Reviews berdasarkan id

Ulasan pengguna untuk satu aplikasi App Store, dari tugas yang diantrekan oleh post_dataforseo_app_apple_app_reviews_submit. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. ⚠️ Ukurannya mengikuti depth yang ditetapkan saat pengiriman dan tidak dapat diperkecil saat fetch.

Referensi harga

Pengukuran: biaya respons yang dilaporkan.
Perkiraan permintaan referensi: USD 0,012.
Pengali pelanggan referensi: 1,0. Jangan menerapkannya lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Parameter Jalur

id
Tipe: string
wajib

pengenal tugas
pengenal tugas unik di sistem kami dalam format UUID
Anda dapat menggunakannya dalam 30 hari untuk meminta hasil tugas kapan saja

Respons

200
Tipe: object | null · Response36Afe1097B20_AppDataAppleAppReviewsTaskGetAdvancedResponseInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

tasks
Tipe: array (object | null)[] | null

array tugas

Tipe: object | null · Response36Afe1097B20_AppDataAppleAppReviewsTaskGetAdvancedTaskInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

data
Tipe: object | null

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

propertyName
Tipe: object | null
id
Tipe: string | null

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

path
Tipe: array (string | null)[] | null

Jalur URL

result
Tipe: array (object | null)[] | null

array hasil

app_id
Tipe: string | null

ID aplikasi yang diterima dalam array POST

check_url
Tipe: string | null

URL langsung ke hasil mesin pencari
Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat

datetime
Tipe: string | null

tanggal dan waktu saat hasil diterima
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
misalnya:
2019-11-15 12:57:46 +00:00

items
Tipe: array (object | null)[] | null

ulasan yang ditemukan

id
Tipe: string | null

id ulasan

position
Tipe: string | null

perataan ulasan di SERP
dapat bernilai sebagai berikut: left

rank_absolute
Tipe: integer | null

peringkat absolut di antara semua ulasan yang terdaftar
posisi absolut di antara semua ulasan dalam daftar

rank_group
Tipe: integer | null

posisi dalam grup elemen dengan nilai type yang identik
posisi elemen dengan nilai type berbeda dihilangkan dari rank_group

rating
Tipe: object | null · Response36Afe1097B20_RatingInfo

skor peringkat yang dikirimkan oleh pengulas

rating_max
Tipe: integer | null

nilai maksimum untuk rating_type

rating_type
Tipe: string | null

jenis penilaian di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

value
Tipe: number | null Format: double

nilai penilaian

votes_count
Tipe: integer | null Format: int64

jumlah umpan balik

review_text
Tipe: string | null

konten ulasan

timestamp
Tipe: string | null

tanggal dan waktu ulasan diterbitkan
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”;
contoh:
2019-11-15 12:57:46 +00:00

title
Tipe: string | null

judul ulasan

type
Tipe: string | null

jenis elemen

user_profile
Tipe: object | null · Response36Afe1097B20_AppUserProfileInfo

profil pengguna pengulas

profile_image_url
Tipe: string | null

URL ke gambar profil pengulas

profile_name
Tipe: string | null

nama profil pengulas

version
Tipe: string | null

versi aplikasi
versi aplikasi yang menerima ulasan tersebut

items_count
Tipe: integer | null Format: int64

jumlah item ulasan dalam array hasil
Anda bisa mendapatkan lebih banyak hasil dengan menggunakan parameter depth saat menyetel tugas

language_code
Tipe: string | null

kode bahasa dalam array POST

location_code
Tipe: integer | null

kode lokasi dalam array POST

rating
Tipe: object | null · Response36Afe1097B20_RatingInfo

peringkat aplikasi
peringkat aplikasi yang ulasannya dikumpulkan

rating_max
Tipe: integer | null

nilai maksimum untuk rating_type

rating_type
Tipe: string | null

jenis penilaian di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

value
Tipe: number | null Format: double

nilai penilaian

votes_count
Tipe: integer | null Format: int64

jumlah umpan balik

reviews_count
Tipe: integer | null Format: int64

jumlah total ulasan
dalam kasus ini, nilainya akan null karena App Store tidak menunjukkan jumlah total ulasan aplikasi

se_domain
Tipe: string | null

domain mesin pencari dalam array POST

title
Tipe: string | null

judul aplikasi
judul aplikasi yang ulasannya dikumpulkan

type
Tipe: string | null

jenis elemen

result_count
Tipe: integer | null Format: int64

jumlah elemen dalam array hasil

status_code
Tipe: integer | null

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

time
Tipe: string | null

waktu eksekusi, detik

tasks_count
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks

tasks_error
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks yang dikembalikan dengan error

time
Tipe: string | null

total waktu eksekusi, detik

version
Tipe: string | null

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

application/json

get/v1/beta/dataforseo/app_data/apple/app_reviews/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/apple/app_reviews/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Tampilkan Skema

{
  "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": [
        {
          "app_id": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "reviews_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "version": null,
              "rating": "[Max Depth Exceeded]",
              "timestamp": null,
              "id": null,
              "title": null,
              "review_text": null,
              "user_profile": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Ambil hasil Apple App Reviews berdasarkan id

AutentikasiRequired

DataForSEO

Ambil hasil Apple App Reviews berdasarkan id

Referensi harga