Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Amazon Ürün Arama Görevlerini Oluşturma

Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları

DataForSEO

​

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

Amazon Ürün Arama Görevlerini Oluşturma

​

keyword için bir Amazon aramasını kuyruğa alır ve bir görev id değeri döndürür. Aramayı location_code, depth ve se_domain şekillendirir. Bu ailenin tamamı eşzamansızdır: gönderim tasks[0].id içinde bir görev id değeri döndürür ve getirme aracı hazır olduğunda sonucu döndürür. ⚠️ Amazon uç noktaları yerel ayar biçiminde bir dil ister — en_US veya English (United States) — ve Google uç noktalarının kabul ettiği yalın en değerini reddeder. Tamamen atlanması da Invalid Field: 'language_name' yanıtı verir; yani bu mesaj hem eksik hem de yanlış değer anlamına gelir, yalnızca yanlış değil. get_dataforseo_merchant_amazon_languages 27 geçerli çifti listeler. get_dataforseo_merchant_amazon_products_fetch ile getirin.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.012.
  • Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde
application/json
  • Tür: array (object | null)[]
    • department
      Tür: string | null

      Amazon ürün departmanı
      isteğe bağlı alan
      ürün listelerini çıkarmak için aşağıdaki Amazon departmanlarından birini belirtin:
      "Arts & Crafts", "Automotive", "Baby", "Beauty & Personal Care", "Books", "Computers", "Digital Music", "Electronics", "Kindle Store", "Prime Video", "Women's Fashion", "Men's Fashion", "Girls' Fashion", "Boys' Fashion", "Deals", "Health & Household", "Home & Kitchen", "Industrial & Scientific", "Luggage", "Movies & TV", "Music, CDs & Vinyl", "Pet Supplies", "Software", "Sports & Outdoors", "Tools & Home Improvement", "Toys & Games", "Video Games"

    • depth
      Tür: integer | null

      ayrıştırma derinliği
      isteğe bağlı alan
      Amazon sonuç sayfasından alınacak sonuç sayısı
      varsayılan değer: 100
      maksimum değer: 700
      Hesabınız 100 sonuca kadar içeren her SERP için faturalandırılır;
      derinliği 100'ün üzerine ayarlamak, arama motoru 100'den fazla sonuç döndürürse ek ücretlere yol açabilir;
      Maliyet Fiyatlandırma sayfasında hesaplanabilir.

    • keyword
      Tür: string

      keyword
      zorunlu alan
      bu alanda en fazla 700 karakter belirtebilirsiniz
      tüm %## kodları çözülecektir (‘+’ karakteri boşluk karakteri olarak çözülür)
      keyword için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;

      DataForSEO API'lerinde keyword ve keywords alanlarının kural ve sınırlamaları hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın

    • language_code
      Tür: string

      arama motoru dil kodu
      belirtmezseniz zorunlu alan language_name
      bu alanı kullanırsanız language_name belirtmeniz gerekmez
      mevcut dillerin listesini language_code parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/amazon/languages
      örnek:
      en_GB

    • language_name
      Tür: string

      arama motoru dilinin tam adı
      belirtmezseniz zorunlu alan language_code
      bu alanı kullanırsanız language_code belirtmeniz gerekmez
      mevcut dillerin listesini language_name parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
      https://api.dataforseo.com/v3/merchant/amazon/languages
      örnek:
      English (United Kingdom)

    • location_code
      Tür: integer

      arama motoru konum kodu
      belirtmezseniz zorunlu alan location_name veya location_coordinate
      bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
      mevcut konumların listesini location_code parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:
      https://api.dataforseo.com/v3/merchant/amazon/locations
      örnek:
      9045969

    • location_coordinate
      Tür: string

      bir konumun GPS koordinatları
      belirtmezseniz zorunlu alan location_name veya location_code
      bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez
      location_coordinate parametresi "latitude,longitude,radius" biçiminde belirtilmelidir
      "latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
      "radius" için minimum değer: 199.9
      örnek:
      53.476225,-2.243572,200

    • location_name
      Tür: string

      arama motoru konumunun tam adı
      belirtmezseniz zorunlu alan location_code veya location_coordinate
      bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
      mevcut konumların listesini location_name parametreleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/merchant/amazon/locations
      örnek:
      HA1,England,United Kingdom

    • max_crawl_pages
      Tür: integer | null

      sayfa tarama sınırı
      isteğe bağlı alan
      taranacak arama sonucu sayfası sayısı
      maksimum değer: 7
      Not: max_crawl_pages ve depth parametreleri birbirini tamamlar;
      daha fazla bilgi için yardım merkezimize bakın

    • pingback_url
      Tür: string | null

      tamamlanan görevin bildirim URL'si
      isteğe bağlı alan
      görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
      ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız
      örnek:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Not: pingback_url içindeki özel karakterler URL kodlanır;
      yani, # karakteri %23 olarak kodlanır

      daha fazla bilgi için Yardım Merkezimize bakın

    • postback_data
      Tür: string

      postback_url veri türü
      postback_url belirtirseniz zorunlu alan
      sunucunuza gönderilecek veri türüne karşılık gelir
      olası değerler:
      advanced, html

    • postback_url
      Tür: string | null

      görev sonuçlarını göndermek için URL
      isteğe bağlı alan
      görev tamamlandığında sonuçlarını gzip biçiminde sıkıştırarak belirttiğiniz postback_url adresine POST isteğiyle göndereceğiz
      ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
      örnek:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Not: postback_url içindeki özel karakterler URL kodlanır;
      yani, # karakteri %23 olarak kodlanır

      daha fazla bilgi için Yardım Merkezimize bakın

    • price_max
      Tür: integer | null

      maksimum ürün fiyatı
      isteğe bağlı alan
      belirtilen sorgu için Amazon'da listelenen döndürülen ürünlerin maksimum fiyatı
      örnek:
      100
      Not: price_max belirtirseniz search_param parametresi yok sayılır

    • price_min
      Tür: integer | null

      minimum ürün fiyatı
      isteğe bağlı alan
      belirtilen sorgu için Amazon'da listelenen döndürülen ürünlerin minimum fiyatı
      örnek:
      5
      Not: price_min belirtirseniz search_param parametresi yok sayılır

    • priority
      Tür: integer | null

      görev önceliği
      isteğe bağlı alan
      şu değerleri alabilir:
      1 – normal yürütme önceliği (varsayılan olarak ayarlanır)
      2 – yüksek yürütme önceliği. Yüksek yürütme önceliğine sahip görevler için ek ücret alınır.
      Maliyet Fiyatlandırma sayfasında hesaplanabilir.

    • se_domain
      Tür: string | null

      arama motoru alan adı
      isteğe bağlı alan
      ilgili arama motoru alan adını belirttiğiniz konum ve dile göre otomatik olarak seçeriz
      ancak bu alanda özel bir arama motoru alan adı ayarlayabilirsiniz
      örnek:
      amazon.com, amazon.co.uk, amazon.fr vb.

    • search_param
      Tür: string | null

      arama sorgusunun ek parametreleri
      isteğe bağlı alan
      aramayı özelleştirmek için aşağıdaki Amazon arama URL'si parametrelerini kullanabilirsiniz
      örnek:
      &low-price=52 – 52 USD'den fazla tutan ürünleri arayın;
      &high-price=45 – 45 USD'den az tutan ürünleri arayın;
      &sort=relevancerank – sonuçları alaka düzeyine göre sıralayın;
      &sort=featured-rank – sonuçları öne çıkan ürünlere göre sıralayın;
      &sort=price-asc-rank – artan fiyata göre sıralayın;
      &sort=price-desc-rank – azalan fiyata göre sıralayın;
      &sort=review-rank – ortalama müşteri yorumları değerine göre sıralayın;
      &sort=date-desc-rank – en yeni gelenlere göre sıralayın
      Not: aşağıdaki parametrelerden herhangi biri kullanılırsa search_param değerleri yok sayılır: price_min, price_max, sort_by

    • sort_by
      Tür: string | null

      sonuç sıralama kuralları
      isteğe bağlı alan
      aşağıdaki sıralama kuralları desteklenir:
      relevance, price_low_to_high, price_high_to_low, featured, avg_customer_review, newest_arrival
      örnek:
      sort_by:"relevance"
      Not: sort_by belirtirseniz search_param parametresi yok sayılır

    • tag
      Tür: string | null

      kullanıcı tanımlı görev tanımlayıcısı
      isteğe bağlı alan
      karakter sınırı 255
      bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
      belirtilen tag değerini yanıtın data nesnesinde bulacaksınız

    • url
      Tür: string | null

      arama sorgusunun doğrudan URL'si
      isteğe bağlı alan
      doğrudan bir URL belirtebilirsiniz ve biz bunu gerekli alanlara ayırırız. Bu yöntemin API'miz için işlenmesi en zor yöntem olduğunu ve URL'de tam dil ile konum belirtmenizi gerektirdiğini unutmayın. Çoğu durumda bu yöntemi önermeyiz.
      örnek:
      https://www.amazon.com/s/?field-keywords=shoes&language=en_US

Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_MerchantAmazonProductsTaskPostResponseInfo
    • cost
      Tür: number | null Biçim: double

      toplam görev maliyeti, USD

    • status_code
      Tür: integer | null

      genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

    • status_message
      Tür: string | null

      genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

    • tasks
      Tür: array (object | null)[] | null

      görev dizisi

      • Tür: object | null · Response36Afe1097B20_MerchantAmazonProductsTaskPostTaskInfo
        • cost
          Tür: number | null Biçim: double

          toplam görev maliyeti, USD

        • data
          Tür: object | null

          POST isteğinde belirttiğiniz parametrelerin aynısını içerir

          • propertyName
            Tür: object | null
        • id
          Tür: string | null

          görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

        • path
          Tür: array (string | null)[] | null

          URL yolu

        • result
          Tür: object | null

          sonuç dizisi
          bu durumda değer null olur

        • result_count
          Tür: integer | null Biçim: int64

          result dizisindeki öğe sayısı

        • status_code
          Tür: integer | null

          görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

        • status_message
          Tür: string | null

          görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

        • time
          Tür: string | null

          yürütme süresi, saniye

    • tasks_count
      Tür: integer | null Biçim: int64

      tasks dizisindeki görev sayısı

    • tasks_error
      Tür: integer | null Biçim: int64

      tasks dizisinde hata ile dönen görev sayısı

    • time
      Tür: string | null

      toplam yürütme süresi, saniye

    • version
      Tür: string | null

      API'nin geçerli sürümü

    application/json
  • 400

    İstek işlenemedi. İstek parametrelerini kontrol edin.

  • 401

    Geçerli bir Felo API anahtarı gerekir.

  • 402

    Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

  • 403

    Hesabın bu işlemi gerçekleştirme izni yok.

  • 429

    İstek veya harcama sınırına ulaşıldı.

  • 502

    Hizmet isteği tamamlayamadı.

  • 503

    API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

  • 504

    İstek işlenirken hizmet zaman aşımına uğradı.

  • default

    Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

    application/json
Request Example for post/v1/beta/dataforseo/merchant/amazon/products/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/products/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en_US",
    "location_code": 2840,
    "keyword": "shoes"
  }
]'
{
  "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
    }
  ]
}
Setting Amazon Products Tasks

Yardım mı gerekiyor?