API Google Shopping
Google Shopping показывает товары и предложения продавцов, найденные Google. search возвращает до 100 товаров по запросу с ценой, продавцом, рейтингом, числом отзывов, изображением и идентификатором товара.
Цены соответствуют рынку, заданному country (по умолчанию us), поэтому вместе с ним меняется и валюта; price — число, извлечённое из price_text. Сузьте результаты с помощью min_price и max_price или отсортируйте по цене или рейтингу через sort.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Google Shopping: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите в Google Shopping по keyword и получайте до 100 товаров с ценой и зачёркнутой ценой, магазином, рейтингом, числом отзывов, изображением и ID товара в Google. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Google Shopping?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите в Google Shopping по | keyword | country, language, max_price, min_price, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | rank · title · product_id · offer_id · image_id · price_text · price · old_price_text · old_price · merchant · multiple_merchants · rating · rating_scale · review_count · image_url · url · platform |
Что означают параметры действия search в API Google Shopping?
Ищите в Google Shopping по keyword и получайте до 100 товаров с ценой и зачёркнутой ценой, магазином, рейтингом, числом отзывов, изображением и ID товара в Google. Задайте рынок через country, фильтруйте по диапазону цен и сортируйте по цене или рейтингу.
keywordОбязательный- Поисковый запрос по товарам, например
wireless earbuds. countryНеобязательный- Двухбуквенный код страны, например
us,gbилиde, для рынка Google Shopping, по которому ведётся поиск (по умолчаниюus). Цены указываются в валюте этого рынка. languageНеобязательный- Двухбуквенный код языка названий и меток, например
enилиde(по умолчаниюen). max_priceНеобязательный- Максимальная цена; не меньше
min_price. min_priceНеобязательный- Минимальная цена в валюте рынка
country; 0 или больше.Google Merchant Center: цена и цена со скидкой в спецификации товарных данных — В спецификации товарных данных Google Merchant Center сказано, что продавцы передают товары с такими атрибутами, как title, price и необязательный sale_price, а Google использует эти данные, чтобы сопоставлять товары с запросами. Источник подтверждает только, что цены в Google Shopping берутся из товарных данных продавцов и разделяются на обычную цену и цену со скидкой; `min_price` и `max_price` этого API фильтруют результаты в валюте страны поиска и определены EveryInfra, а источник не ручается за этот фильтр или количество результатов. · Проверено sortНеобязательный- Порядок сортировки:
price_low(по возрастанию цены),price_high(по убыванию цены) илиrating(сначала с лучшим рейтингом). Без параметра результаты сортируются по релевантности.
Как использовать API Google Shopping
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_shopping","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Google Shopping
Какие данные можно получить через API Google Shopping?
Укажите в platform значение google_shopping. В текущем каталоге: поиск. Эти названия действий соответствуют разным объектам или представлениям Google Shopping; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Google Shopping?
Поисковый запрос по товарам, например wireless earbuds. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Google Shopping?
Объявленная схема включает rank, title, product_id и offer_id. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Google Shopping возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.