Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Отримати результати Google Shopping Sellers за id

Сервер:https://openapi.felo.ai
Клієнтські бібліотеки

DataForSEO

​

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

Отримати результати Google Shopping Sellers за id

​

Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Це подання для порівняння цін; сам товар — get_dataforseo_merchant_google_product_info_fetch.

Довідкові ціни

  • Тарифікація: вартість відповіді за даними постачальника.
  • Довідкова оцінка запиту: USD 0.012.
  • Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Параметри шляху
  • id
    Тип: string
    обов'язкове

    ідентифікатор завдання
    унікальний ідентифікатор завдання в нашій системі у форматі UUID
    протягом 30 днів ви зможете будь-коли запросити за ним результати завдання

Відповіді
  • 200
    Тип: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskGetAdvancedResponseInfo
    • cost
      Тип: number | null Формат: double

      загальна вартість завдань, USD

    • status_code
      Тип: integer | null

      загальний код стану. Повний список кодів відповіді можна знайти тут.

    • status_message
      Тип: string | null

      загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

    • tasks
      Тип: array (object | null)[] | null

      масив завдань

      • Тип: object | null · Response36Afe1097B20_MerchantGoogleSellersTaskGetAdvancedTaskInfo
        • cost
          Тип: number | null Формат: double

          загальна вартість завдань, USD

        • data
          Тип: object | null

          містить ті самі параметри, які ви вказали в POST-запиті

          • propertyName
            Тип: object | null
        • id
          Тип: string | null

          ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

        • path
          Тип: array (string | null)[] | null

          шлях URL

        • result
          Тип: array (object | null)[] | null

          масив результатів

          • check_url
            Тип: string | null

            прямий URL до результатів Google Shopping
            його можна використовувати, щоб переконатися, що ми надали точні результати

          • datetime
            Тип: string | null

            дата й час отримання результату
            у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            приклад:
            2019-11-15 12:57:46 +00:00

          • image_url
            Тип: string | null

            URL зображення товару

          • item_types
            Тип: array (string | null)[] | null

            типи результатів пошуку, знайдених у Google Shopping SERP
            містить типи всіх результатів пошуку (items), знайдених у поверненому SERP
            можливі типи елементів:
            shops_list, buy_on_google

          • items
            Тип: array (object | null)[] | null

            елементи в SERP

            • base_price
              Тип: number | null

              ціна товару без урахування податку та доставки

            • currency
              Тип: string | null

              валюта у форматі ISO
              приклад:
              USD

            • details
              Тип: string | null

              подробиці та спеціальні пропозиції
              якщо подробиць немає, значення буде null

            • domain
              Тип: string | null

              домен у SERP

            • position
              Тип: string | null

              вирівнювання елемента в Google Shopping SERP
              можливі значення:
              left, right

            • rank_absolute
              Тип: integer | null

              абсолютний ранг у SERP
              абсолютна позиція серед усіх елементів, знайдених у Google Shopping SERP

            • rank_group
              Тип: integer | null

              позиція в групі елементів з однаковими значеннями type
              позиції елементів з іншими значеннями type виключаються з rank_group

            • seller_name
              Тип: string | null

              назва продавця
              назва компанії, яка розмістила відповідний товар у Google Shopping

            • shipping_price
              Тип: number | null

              вартість доставки товару

            • shop_ad_aclk
              Тип: string | null

              унікальний параметр реферального переходу за оголошенням
              за допомогою цього параметра можна отримати URL оголошення в Google Shopping Sellers Ad URL

            • tax
              Тип: number | null

              сума податку
              податок вказується як фактична сума грошей, а не як відсоток

            • title
              Тип: string | null

              назва товару

            • total_price
              Тип: number | null Формат: int64

              ціна товару з урахуванням податку та доставки

            • type
              Тип: string | null

              тип елемента

            • url
              Тип: string | null

              URL-переадресація Google Shopping на сторінку товару на сайті продавця
              якщо ви хочете отримати URL оголошення, що веде на сторінку товару на сайті продавця, зверніться до ендпоінта Google Shopping Sellers Ad URL

            • xpath
              Тип: string | null

              XPath елемента

          • items_count
            Тип: integer | null Формат: int64

            кількість результатів, повернутих у масиві items

          • language_code
            Тип: string | null

            код мови в масиві POST

          • location_code
            Тип: integer | null

            код місцеположення в масиві POST

          • product_id
            Тип: string | null

            product_id, отриманий у масиві POST
            докладніше про параметр — у цьому посібнику довідкового центру

          • rating
            Тип: object | null · Response36Afe1097B20_RatingInfo

            рейтинг товару
            показник популярності товару на основі відгуків про товар

            • rating_max
              Тип: integer | null

              максимальне значення для rating_type

            • rating_type
              Тип: string | null

              тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax

            • value
              Тип: number | null Формат: double

              значення рейтингу

            • votes_count
              Тип: integer | null Формат: int64

              кількість відгуків

          • se_domain
            Тип: string | null

            домен пошукової системи в масиві POST

          • title
            Тип: string | null

            назва товару

          • type
            Тип: string | null

            тип елемента

          • url
            Тип: string | null

            URL сторінки товару

        • result_count
          Тип: integer | null Формат: int64

          кількість елементів у масиві result

        • status_code
          Тип: integer | null

          код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

        • status_message
          Тип: string | null

          інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

        • time
          Тип: string | null

          час виконання, секунди

    • tasks_count
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks

    • tasks_error
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks, повернутих з помилкою

    • time
      Тип: string | null

      загальний час виконання, секунди

    • version
      Тип: string | null

      поточна версія API

    application/json
  • 400

    Не вдалося обробити запит. Перевірте параметри запиту.

  • 401

    Потрібен дійсний API-ключ Felo.

  • 402

    Запит неможливо виконати: умови білінгу не виконано.

  • 403

    Обліковий запис не має дозволу на цю операцію.

  • 429

    Досягнуто ліміту запитів або витрат.

  • 502

    Служба не змогла виконати запит.

  • 503

    API або служба білінгу тимчасово недоступні.

  • 504

    Час очікування обробки запиту вичерпано.

  • default

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    application/json
Request Example for get/v1/beta/dataforseo/merchant/google/sellers/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/sellers/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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": [
        {
          "product_id": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "url": null,
          "image_url": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "domain": null,
              "title": null,
              "url": null,
              "details": null,
              "base_price": null,
              "tax": null,
              "shipping_price": null,
              "total_price": null,
              "currency": null,
              "seller_name": null,
              "shop_ad_aclk": null
            }
          ]
        }
      ]
    }
  ]
}
Get Google Shopping Sellers Results by id