DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Membuat tugas Apple App List
Mengantrekan salah satu koleksi kurasi App Store, dipilih dengan app_collection, mengembalikan id tugas. depth membatasi seberapa jauh membaca daftar peringkat. Asinkron: pengiriman mengembalikan id tugas di tasks[0].id dan alat fetch mengembalikan hasil setelah siap. Ambil dengan get_dataforseo_app_apple_app_list_fetch. Bagian Apple tidak memiliki varian HTML.
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.
- Tipe: array (object | null)[]
- appTipe: string | null
_category kategori aplikasi di App Store field opsional Anda dapat memfilter hasil berdasarkan kategori aplikasi; contoh: lifestyle; Anda dapat meninjau daftar lengkap kategori yang tersedia di sini atau dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/app_data/apple/categories
- appTipe: string
_collection koleksi aplikasi field wajib koleksi aplikasi di App Store tempat aplikasi akan dikumpulkan; Anda dapat menentukan nilai berikut: top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios, new_paid_ios
- depthTipe: integer | null
kedalaman parsing field opsional jumlah aplikasi yang akan dikembalikan dari SERP App Store; nilai default: 100 nilai maksimum: 100 Akun Anda akan ditagih untuk setiap SERP yang berisi hingga 100 hasil; Biaya dapat dihitung di halaman Harga.
- languageTipe: string | null
_code kode bahasa mesin pencari field wajib jika Anda tidak menentukan language_name jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name Anda dapat menerima daftar bahasa yang tersedia beserta language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/app_data/apple/languages contoh: en
- languageTipe: string | null
_name nama lengkap bahasa mesin pencari field wajib jika Anda tidak menentukan language_code jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code Anda dapat menerima daftar bahasa yang tersedia dengan language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/app_data/apple/languages contoh: English
- locationTipe: integer | null
_code kode lokasi mesin pencari field wajib jika Anda tidak menentukan location_name jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name Anda dapat menerima daftar lokasi mesin pencari yang tersedia beserta location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/app_data/apple/locations contoh: 9061121
- locationTipe: string | null
_name nama lengkap lokasi mesin pencari field wajib jika Anda tidak menentukan location_code jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code Anda dapat menerima daftar lokasi mesin pencari yang tersedia dengan location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/app_data/apple/locations contoh: West Los Angeles,California,United States
- pingbackTipe: string | null
_url URL notifikasi tugas yang selesai field opsional saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Catatan: karakter khusus dalam pingback_url akan di-urlencode; yaitu, karakter # akan dienkode menjadi %23 pelajari selengkapnya di Pusat Bantuan kami
- postbackTipe: string | null
_data tipe data postback_url field wajib jika Anda menentukan postback_url sesuai dengan tipe data yang akan dikirim ke server Anda nilai yang mungkin: advanced
- postbackTipe: string | null
_url URL untuk mengirim hasil tugas field opsional setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan. contoh: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Catatan: karakter khusus dalam postback_url akan di-urlencode; yaitu, karakter # akan dienkode menjadi %23 pelajari selengkapnya di Pusat Bantuan kami
- priorityTipe: integer | null
prioritas tugas field opsional dapat mengambil nilai berikut: 1 – prioritas eksekusi normal (ditetapkan secara default) 2 – prioritas eksekusi tinggi Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi. Biaya dapat dihitung di halaman Harga.
- tagTipe: string | null
pengenal tugas yang ditentukan pengguna field opsional batas karakter adalah 255 Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil Anda akan menemukan nilai tag yang ditentukan di objek data respons
- Tipe: object | null · Response36Afe1097B20_AppDataAppleAppListTaskPostResponseInfo200
- Tipe: number | null Format: doublecost
total biaya tugas, USD
- Tipe: integer | nullstatus
_code kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini
- Tipe: string | nullstatus
_message pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- Tipe: array (object | null)[] | nulltasks
array tugas
- Tipe: object | null · Response36Afe1097B20_AppDataAppleAppListTaskPostTaskInfo
- costTipe: number | null Format: double
total biaya tugas, USD
- dataTipe: object | null
berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST
- propertyTipe: object | null
Name
- idTipe: string | null
pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID
- pathTipe: array (string | null)[] | null
Jalur URL
- resultTipe: object | null
array hasil; dalam kasus ini, nilainya akan null
- resultTipe: integer | null Format: int64
_count jumlah elemen dalam array hasil
- statusTipe: integer | null
_code kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini
- statusTipe: string | null
_message pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini
- timeTipe: string | null
waktu eksekusi, detik
- Tipe: integer | null Format: int64tasks
_count jumlah tugas dalam array tasks
- Tipe: integer | null Format: int64tasks
_error jumlah tugas dalam array tasks yang dikembalikan dengan error
- Tipe: string | nulltime
total waktu eksekusi, detik
- Tipe: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/apple/app_list/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_collection": "top_free_ios",
"location_code": 2840,
"language_code": "en",
"app_category": "games"
}
]'
{
"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": null
}
]
}