Felo API PlatformFelo API Platform
Wszystkie endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tworzenie zadań sprzedawców Amazon

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

DataForSEO

​

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

DataForSEO Operacje

Tworzenie zadań sprzedawców Amazon

​

Kolejkuje listę sprzedawców oferujących jeden produkt Amazon i zwraca id zadania. Cała ta rodzina jest asynchroniczna: submit zwraca id zadania w tasks[0].id, a narzędzie fetch zwraca wynik, gdy będzie gotowy. ⚠️ Endpointy Amazon wymagają języka w formacie locale — en_US lub English (United States) — i odrzucają samo en, które przyjmują endpointy Google. Pominięcie go również zwraca Invalid Field: 'language_name', więc ten komunikat oznacza wartość błędną lub brakującą, nie tylko błędną. get_dataforseo_merchant_amazon_languages zawiera 27 prawidłowych par. Pobierz przez get_dataforseo_merchant_amazon_sellers_fetch.

Cennik referencyjny

  • Rozliczanie: zgłoszony koszt odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.012.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej już kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
application/json
  • Typ: array (object | null)[]
    • asin
      Typ: string

      unikalny identyfikator produktu w Amazon
      pole wymagane
      tę wartość możesz uzyskać, wysyłając osobne żądanie do endpointu Amazon Products
      pamiętaj, że nie istnieje pełna lista możliwych wartości, ponieważ asin jest wartością dynamiczną nadawaną przez Amazon
      przykład:
      B085RFFC9Q
      więcej o identyfikatorze w tym przewodniku Centrum pomocy

    • language_code
      Typ: string

      kod języka
      pole wymagane, jeśli nie podasz language_name
      jeśli używasz tego pola, nie musisz podawać language_name
      listę dostępnych języków Amazon wraz z ich language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/amazon/languages
      przykład:
      en_US

    • language_name
      Typ: string

      pełna nazwa języka
      pole wymagane, jeśli nie podasz language_code
      jeśli używasz tego pola, nie musisz podawać language_code
      listę dostępnych języków Amazon wraz z ich language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/amazon/languages
      przykład:
      English (United States)

    • location_code
      Typ: integer

      kod lokalizacji
      pole wymagane, jeśli nie podasz location_name ani location_coordinate
      jeśli używasz tego pola, nie musisz podawać location_name ani location_coordinate
      listę dostępnych lokalizacji Amazon wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/amazon/locations
      przykład:
      2840

    • location_coordinate
      Typ: string

      współrzędne GPS lokalizacji
      pole wymagane, jeśli nie podasz location_name ani location_code
      jeśli używasz tego pola, nie musisz podawać location_name ani location_code
      parametr location_coordinate należy podać w formacie "latitude,longitude,radius"
      maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
      minimalna wartość dla "radius": 199.9
      przykład:
      53.476225,-2.243572,200

    • location_name
      Typ: string

      pełna nazwa lokalizacji
      pole wymagane, jeśli nie podasz location_code ani location_coordinate
      jeśli używasz tego pola, nie musisz podawać location_code ani location_coordinate
      listę dostępnych lokalizacji Amazon wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/merchant/amazon/locations
      przykład:
      London,England,United Kingdom

    • pingback_url
      Typ: string | null

      adres URL powiadomienia o zakończonym zadaniu
      pole opcjonalne
      po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
      możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości
      przykład:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
      m.in. znak # zostanie zakodowany jako %23

      więcej informacji znajdziesz w Centrum pomocy

    • postback_data
      Typ: string

      typ danych postback_url
      pole wymagane, jeśli podasz postback_url
      odpowiada typowi danych, który zostanie wysłany na Twój serwer
      możliwe wartości:
      advanced, html

    • postback_url
      Typ: string | null

      adres URL do wysyłania wyników zadania
      pole opcjonalne
      po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
      możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
      przykład:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
      m.in. znak # zostanie zakodowany jako %23

      więcej informacji znajdziesz w Centrum pomocy

    • priority
      Typ: integer | null

      priorytet zadania
      pole opcjonalne
      może przyjmować następujące wartości:
      1 – normalny priorytet wykonania (ustawiany domyślnie)
      2 – wysoki priorytet wykonania. Za zadania o wysokim priorytecie wykonania zostanie naliczona dodatkowa opłata.
      Koszt można obliczyć na stronie Cennik.

    • se_domain
      Typ: string | null

      domena wyszukiwarki
      pole opcjonalne
      odpowiednią domenę wyszukiwarki wybieramy automatycznie na podstawie podanej lokalizacji i języka
      możesz jednak ustawić niestandardową domenę wyszukiwarki w tym polu
      przykład:
      amazon.co.uk, amazon.com.au, amazon.de itd.

    • tag
      Typ: string | null

      identyfikator zadania zdefiniowany przez użytkownika
      pole opcjonalne
      limit znaków: 255
      ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
      podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi
  • 200
    Typ: object | null · Response36Afe1097B20_MerchantAmazonSellersTaskPostResponseInfo
    • cost
      Typ: number | null Format: double

      łączny koszt zadań, USD

    • status_code
      Typ: integer | null

      ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

    • status_message
      Typ: string | null

      ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

    • tasks
      Typ: array (object | null)[] | null

      tablica zadań

      • Typ: object | null · Response36Afe1097B20_MerchantAmazonSellersTaskPostTaskInfo
        • cost
          Typ: number | null Format: double

          łączny koszt zadań, USD

        • data
          Typ: object | null

          zawiera te same parametry, które podano w żądaniu POST

          • propertyName
            Typ: object | null
        • id
          Typ: string | null

          identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

        • path
          Typ: array (string | null)[] | null

          ścieżka URL

        • result
          Typ: object | null

          tablica wyników
          w tym przypadku wartością będzie null

        • result_count
          Typ: integer | null Format: int64

          liczba elementów w tablicy result

        • status_code
          Typ: integer | null

          kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

        • status_message
          Typ: string | null

          komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

        • time
          Typ: string | null

          czas wykonania, sekundy

    • tasks_count
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks

    • tasks_error
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks zwróconych z błędem

    • time
      Typ: string | null

      łączny czas wykonania, sekundy

    • version
      Typ: string | null

      bieżąca wersja interfejsu API

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    application/json
Request Example for post/v1/beta/dataforseo/merchant/amazon/sellers/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/amazon/sellers/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "asin": "B085RFFC9Q"
  }
]'

{
  "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
    }
  ]
}

Operacja zakończona powodzeniem

Setting Amazon Sellers Tasks