v0.2.0-beta

OpenAPI 3.1.0

Dapatkan Hasil Penjual Amazon mengikut id

Felo API Support

MIT

Pelayan

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/merchant/amazon/sellers/task_get/advanced/{id}

Dapatkan Hasil Penjual Amazon mengikut id

Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Ini menjawab siapa lagi yang ada dalam buy box; produk itu sendiri ialah get_dataforseo_merchant_amazon_asin_fetch. Gunakan hanya apabila hasil terhurai kekurangan sesuatu yang boleh anda tunjukkan.

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.

Parameter Laluan

id
Jenis: string
wajib

pengecam tugas
pengecam tugas unik dalam sistem kami dalam format UUID
anda boleh menggunakannya dalam tempoh 30 hari untuk meminta hasil tugas pada bila-bila masa

Respons

200
Jenis: object | null · Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResponseInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

status_code
Jenis: integer | null

kod status umum; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

tatasusunan tugas

Jenis: object | null · Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedTaskInfo
cost
Jenis: number | null Format: double

jumlah kos tugas, USD

data
Jenis: object | null

mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

propertyName
Jenis: object | null
id
Jenis: string | null

pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

Laluan URL

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

tatasusunan hasil

asin
Jenis: string | null

asin yang diterima dalam array POST
ketahui lebih lanjut tentang ASIN dalam panduan Pusat Bantuan ini

check_url
Jenis: string | null

URL terus ke hasil Amazon
anda boleh menggunakannya untuk memastikan hasil yang disediakan tepat

datetime
Jenis: string | null

tarikh dan masa hasil diterima
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2019-11-15 12:57:46 +00:00

image
Jenis: string | null

url imej produk
URL imej produk yang berkaitan dengan asin yang diterima dalam array POST

item_types
Jenis: array (string | null)[] | null

jenis hasil carian yang ditemui dalam SERP Amazon Sellers
mengandungi jenis semua hasil carian (items) yang ditemui dalam SERP yang dipulangkan
jenis item yang mungkin:
amazon_seller_main_item, amazon_seller_item

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

item dalam SERP

applicable_vouchers
Jenis: array (object | null)[] | null

array objek yang mengandungi maklumat tentang baucar yang berkenaan

fixed_discount
Jenis: number | null

nilai diskaun tetap

fixed_discount_currency
Jenis: string | null

kod mata wang diskaun tetap

important_details
Jenis: string | null

butiran penting tentang terma baucar diskaun

percentage_discount
Jenis: number | null

nilai diskaun peratusan
jika diskaun adalah tetap, nilainya akan null

text
Jenis: string | null

teks baucar

type
Jenis: string | null

jenis elemen

condition
Jenis: string | null

keadaan produk
keadaan produk yang ditawarkan oleh penjual

condition_description
Jenis: string | null

butiran keadaan produk
butiran lanjutan tentang keadaan produk yang ditawarkan oleh penjual

delivery_info
Jenis: object | null · Response36Afe1097B20_AmazonDeliveryInfo

maklumat penghantaran
maklumat penghantaran termasuk julat tarikh penghantaran percuma dan pantas

delivery_date_from
Jenis: string | null

tarikh paling awal produk boleh dihantar

delivery_date_to
Jenis: string | null

tarikh paling lewat produk boleh dihantar

delivery_message
Jenis: string | null

mesej yang menyertai maklumat penghantaran seperti yang disiarkan oleh penjual

delivery_price
Jenis: object | null · Response36Afe1097B20_PriceInfo

harga untuk penghantaran harga penghantaran berdasarkan lokasi yang anda tentukan dalam permintaan POST; jika penghantaran percuma tersedia, nilainya null

currency
Jenis: string | null

mata wang bagi harga yang disenaraikan kod ISO mata wang yang digunakan pada harga

current
Jenis: number | null Format: double

harga semasa menunjukkan harga semasa produk atau perkhidmatan yang dipaparkan dalam hasil

displayed_price
Jenis: string | null

rentetan harga dalam hasil rentetan harga mentah seperti yang diberikan dalam hasil

is_price_range
Jenis: boolean | null

harga diberikan sebagai julat menunjukkan sama ada harga diberikan dalam julat

max_value
Jenis: number | null Format: double

harga maksimum harga maksimum produk atau perkhidmatan seperti yang dinyatakan dalam hasil

regular
Jenis: number | null Format: double

harga biasa menunjukkan harga biasa produk atau perkhidmatan tanpa diskaun

fastest_delivery_date_from
Jenis: string | null

tarikh paling awal produk boleh dihantar dengan pilihan penghantaran pantas

fastest_delivery_date_to
Jenis: string | null

tarikh paling lewat produk boleh dihantar dengan pilihan penghantaran pantas

percentage_discount
Jenis: number | null

nilai peratusan diskaun

position
Jenis: string | null

penjajaran elemen dalam SERP
nilai yang mungkin:
left, right

price
Jenis: object | null · Response36Afe1097B20_PriceInfo

butiran harga produk
jika tiada butiran, nilainya ialah null

currency
Jenis: string | null

mata wang bagi harga yang disenaraikan kod ISO mata wang yang digunakan pada harga

current
Jenis: number | null Format: double

harga semasa menunjukkan harga semasa produk atau perkhidmatan yang dipaparkan dalam hasil

displayed_price
Jenis: string | null

rentetan harga dalam hasil rentetan harga mentah seperti yang diberikan dalam hasil

is_price_range
Jenis: boolean | null

harga diberikan sebagai julat menunjukkan sama ada harga diberikan dalam julat

max_value
Jenis: number | null Format: double

harga maksimum harga maksimum produk atau perkhidmatan seperti yang dinyatakan dalam hasil

regular
Jenis: number | null Format: double

harga biasa menunjukkan harga biasa produk atau perkhidmatan tanpa diskaun

rank_absolute
Jenis: integer | null

kedudukan mutlak dalam SERP
kedudukan mutlak antara semua elemen yang ditemui dalam Amazon Sellers SERP

rank_group
Jenis: integer | null

kedudukan dalam kumpulan elemen dengan nilai type yang sama
kedudukan elemen dengan nilai type berbeza dikecualikan daripada rank_group

rating
Jenis: object | null · Response36Afe1097B20_RatingElement

butiran penilaian penjual
kadar populariti penjual berdasarkan ulasan pelanggan

position
Jenis: string | null

penjajaran elemen dalam Google Shopping SERP
nilai yang mungkin:
left, right

rating_max
Jenis: integer | null

nilai maksimum untuk rating_type

rating_type
Jenis: string | null

jenis penilaian
di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

type
Jenis: string | null

jenis elemen

value
Jenis: number | null

nilai penilaian

votes_count
Jenis: integer | null Format: int64

jumlah maklum balas

seller_name
Jenis: string | null

nama perniagaan penjual

seller_url
Jenis: string | null

URL pemajuan ke halaman penjual di Amazon

ships_from
Jenis: string | null

nama syarikat penghantar

type
Jenis: string | null

jenis elemen

xpath
Jenis: string | null

XPath elemen

items_count
Jenis: integer | null Format: int64

bilangan hasil yang dipulangkan dalam tatasusunan items

language_code
Jenis: string | null

kod bahasa yang diterima dalam array POST

location_code
Jenis: integer | null

kod lokasi yang diterima dalam array POST

se_domain
Jenis: string | null

domain enjin carian yang diterima dalam array POST

title
Jenis: string | null

tajuk produk
tajuk produk yang berkaitan dengan asin yang diterima dalam array POST

type
Jenis: string | null

jenis elemen

result_count
Jenis: integer | null Format: int64

bilangan elemen dalam array hasil

status_code
Jenis: integer | null

kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

status_message
Jenis: string | null

mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

time
Jenis: string | null

masa pelaksanaan, saat

tasks_count
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks

tasks_error
Jenis: integer | null Format: int64

bilangan tugas dalam array tasks yang dipulangkan dengan ralat

time
Jenis: string | null

jumlah masa pelaksanaan, saat

version
Jenis: string | null

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

get/v1/beta/dataforseo/merchant/amazon/sellers/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/sellers/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Tunjukkan 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": [
        {
          "asin": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "image": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "seller_name": null,
              "seller_url": null,
              "ships_from": null,
              "price": "[Max Depth Exceeded]",
              "percentage_discount": null,
              "applicable_vouchers": [
                "[Max Depth Exceeded]"
              ],
              "rating": "[Max Depth Exceeded]",
              "condition": null,
              "condition_description": null,
              "delivery_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

Dapatkan Hasil Penjual Amazon mengikut id

PengesahanRequired

DataForSEO

Dapatkan Hasil Penjual Amazon mengikut id

Rujukan harga