DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Menetapkan Tugas ASIN Amazon
Memasukkan pencarian satu produk Amazon mengikut asin ke baris gilir, sambil memulangkan id tugas. Keluarga ini tak segerak sepenuhnya: submit memulangkan id tugas dalam tasks[0].id, dan alat fetch memulangkan hasil apabila sedia. ⚠️ Endpoint Amazon memerlukan bahasa dalam bentuk locale - en_US, atau English (United States) - dan menolak en kosong yang diterima oleh endpoint Google. Meninggalkannya sepenuhnya juga menjawab Invalid Field: 'language_name', jadi mesej itu bermaksud salah atau tiada, bukan sekadar salah. get_dataforseo_merchant_amazon_languages menyenaraikan 27 pasangan yang sah. Ambil dengan get_dataforseo_merchant_amazon_asin_fetch.
Rujukan harga
- Pemeteran: Kos respons yang dilaporkan.
- Anggaran rujukan setiap permintaan: USD 0.012.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: array (object | null)[]
- asinJenis: string
- languageJenis: string
_code kod bahasa enjin carian
medan wajib jika anda tidak menentukanlanguage_name
jika anda menggunakan medan ini, anda tidak perlu menentukanlanguage_name
anda boleh menerima senarai bahasa yang tersedia dengan parameterlanguage_codedengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/merchant/amazon/languages
contoh:en_GB - languageJenis: string
_name nama penuh bahasa enjin carian
medan wajib jika anda tidak menentukanlanguage_code
jika anda menggunakan medan ini, anda tidak perlu menentukanlanguage_code
anda boleh menerima senarai bahasa yang tersedia dengan parameterlanguage_namedengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/merchant/amazon/languages
contoh:English (United Kingdom) - locationJenis: integer
_code kod lokasi enjin carian
medan wajib jika anda tidak menentukanlocation_nameataulocation_coordinate
jika anda menggunakan medan ini, anda tidak perlu menentukanlocation_nameataulocation_coordinate
anda boleh menerima senarai lokasi yang tersedia dengan parameterlocation_codedengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/merchant/amazon/locations
contoh:9045969 - locationJenis: string
_coordinate koordinat GPS sesuatu lokasi
medan wajib jika anda tidak menentukanlocation_nameataulocation_code
jika anda menggunakan medan ini, anda tidak perlu menentukanlocation_nameataulocation_code
parameterlocation_coordinatehendaklah ditentukan dalam format "latitude,longitude,radius"
bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7
nilai minimum untuk "radius": 199.9
contoh:53.476225,-2.243572,200 - locationJenis: string
_name nama penuh lokasi enjin carian
medan wajib jika anda tidak menentukanlocation_codeataulocation_coordinate
jika anda menggunakan medan ini, anda tidak perlu menentukanlocation_codeataulocation_coordinate
anda boleh menerima senarai lokasi yang tersedia dengan parameterlocation_namedengan membuat permintaan berasingan kehttps://api.dataforseo.com/v3/merchant/amazon/locations
contoh:HA1,England,United Kingdom - pingbackJenis: string | null
_url URL pemberitahuan tugas yang selesai
medan pilihan
apabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan
anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah$iddan ‘$tag’ sebagai pemboleh ubah$tagyang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
contoh:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Nota: aksara khas dalampingback_urlakan di-urlencode;
iaitu, aksara#akan dikodkan menjadi%23 - postbackJenis: string
_data jenis data postback_url
medan wajib jika anda menentukanpostback_url
sepadan dengan jenis data yang akan dihantar ke pelayan anda
nilai yang mungkin:advanced,html - postbackJenis: string | null
_url URL untuk menghantar hasil tugas
medan pilihan
selepas tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam formatgzipkepostback_urlyang anda tentukan
anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah$iddan ‘$tag’ sebagai pemboleh ubah$tagyang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
contoh:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Nota: aksara khas dalampostback_urlakan di-urlencode;
iaitu, aksara#akan dikodkan menjadi%23 - priorityJenis: integer | null
- seJenis: string | null
_domain domain enjin carian
medan pilihan
kami memilih domain enjin carian yang berkaitan secara automatik mengikut lokasi dan bahasa yang anda tentukan
namun begitu, anda boleh menetapkan domain enjin carian tersuai dalam medan ini
contoh:amazon.com,amazon.co.uk,amazon.fr, dsb. - tagJenis: string | null
pengecam tugas yang ditentukan pengguna
medan pilihan
had aksara ialah 255
anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
anda akan menemui nilaitagyang ditentukan dalam objekdatarespons
- Jenis: object | null · Response36Afe1097B20_MerchantAmazonAsinTaskPostResponseInfo200
- Jenis: number | null Format: doublecost
jumlah kos tugas, USD
- Jenis: integer | nullstatus
_code kod status umum; anda boleh menemui senarai penuh kod respons di sini
- Jenis: string | nullstatus
_message mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini
- Jenis: array (object | null)[] | nulltasks
tatasusunan tugas
- Jenis: object | null · Response36Afe1097B20_MerchantAmazonAsinTaskPostTaskInfo
- costJenis: number | null Format: double
jumlah kos tugas, USD
- dataJenis: object | null
mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST
- propertyJenis: object | null
Name
- idJenis: string | null
pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID
- pathJenis: array (string | null)[] | null
Laluan URL
- resultJenis: object | null
tatasusunan hasil
dalam kes ini, nilainya akan menjadinull - resultJenis: integer | null Format: int64
_count bilangan elemen dalam array hasil
- statusJenis: integer | null
_code kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini
- statusJenis: string | null
_message mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini
- timeJenis: string | null
masa pelaksanaan, saat
- Jenis: integer | null Format: int64tasks
_count bilangan tugas dalam array tasks
- Jenis: integer | null Format: int64tasks
_error bilangan tugas dalam array tasks yang dipulangkan dengan ralat
- Jenis: string | nulltime
jumlah masa pelaksanaan, saat
- Jenis: string | nullversion
versi semasa API
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/asin/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en_US",
"location_code": 2840,
"asin": "B0756FCPPN"
}
]'
{
"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
}
]
}