DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Массовый объём поиска Amazon
Объём поиска Amazon сразу для многих ключевых слов за один вызов. Здесь нет параметра limit, но оплата идёт за вызов, а не за элемент, поэтому отправляйте весь список сразу. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Цена за вызов, поэтому отправляйте весь список. Эндпоинт объёма на стороне Google — post_dataforseo_labs_google_keyword_overview_live, и эти два измеряют совершенно разные торговые площадки.
Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.1356.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Только справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: array (object | null)[]
- keywordsТип: array string[]
- languageТип: string | null
_code код языка
обязательное поле, если не указанlanguage_name
список доступных языков с ихlanguage_codeможно получить отдельным запросом кhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Примечание: этот эндпоинт сейчас поддерживает только эти местоположения и языки;
пример:en - languageТип: string
_name полное название языка
обязательное поле, если не указанlanguage_code
список доступных языков с ихlanguage_nameможно получить отдельным запросом кhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
Примечание: этот эндпоинт сейчас поддерживает только эти местоположения и языки;
пример:English - locationТип: integer
_code код местоположения
обязательное поле, если не указанlocation_name
список доступных местоположений сlocation_codeможно получить отдельным запросом кhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примечание: этот эндпоинт сейчас поддерживает только эти местоположения и языки;
пример:2840 - locationТип: string
_name полное название местоположения
обязательное поле, если не указанlocation_code
список доступных местоположений с ихlocation_nameможно получить отдельным запросом кhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Примечание: этот эндпоинт сейчас поддерживает только следующие местоположения и языки:Australia-2036,enAustria-2040,deCanada-2124,enEgypt-2818,arFrance-2250,frGermany-2276,deIndia-2356,enItaly-2380,itMexico-2484,esNetherlands-2528,nlSaudi Arabia-2682,arSingapore-2702,enSpain-2724,esUnited Arab Emirates-2784,arUnited Kingdom-2826,enUnited States-2840,en
пример:United States - tagТип: string | null
пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значениеtagвы найдёте в объектеdataответа
- Тип: object | null · Response36Afe1097B20_DataforseoLabsAmazonBulkSearchVolumeLiveResponseInfo200
- Тип: number | null Формат: doublecost
общая стоимость задач, USD
- Тип: integer | nullstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь.
- Тип: string | nullstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array (object | null)[] | nulltasks
массив задач
- Тип: object | null · Response36Afe1097B20_DataforseoLabsAmazonBulkSearchVolumeLiveTaskInfo
- costТип: number | null Формат: double
общая стоимость задач, USD
- dataТип: object | null
содержит те же параметры, что вы указали в POST-запросе
- propertyТип: object | null
Name
- idТип: string | null
идентификатор задачи уникальный идентификатор задачи в нашей системе в формате UUID
- pathТип: array (string | null)[] | null
путь URL
- resultТип: array (object | null)[] | null
массив результатов
- itemsТип: array (object | null)[] | null
содержит данные об объёме поиска по ключевому слову
- keywordТип: string | null
ключевое слово в массиве POST
- seТип: string | null
_type тип поисковой системы
- searchТип: integer | null Формат: int64
_volume средняя месячная частота поискового объёма
представляет (приблизительное) число запросов по возвращённому ключевому слову на Amazon
- itemsТип: integer | null Формат: int64
_count количество результатов, возвращённых в массиве
items - languageТип: string | null
_code код языка в массиве POST
если данных нет, значение —null - locationТип: integer | null
_code код местоположения в массиве POST
если данных нет, значение —null - seТип: string | null
_type тип поисковой системы
- totalТип: integer | null Формат: int64
_count общее количество результатов в нашей базе данных, соответствующих вашему запросу
- resultТип: integer | null Формат: int64
_count число элементов в массиве result
- statusТип: integer | null
_code код состояния задачи формируется DataForSEO, может находиться в диапазоне 10000-60000 Полный список кодов ответа можно найти здесь.
- statusТип: string | null
_message информационное сообщение задачи Полный список общих информационных сообщений можно найти здесь.
- timeТип: string | null
время выполнения, секунды
- Тип: integer | null Формат: int64tasks
_count число задач в массиве tasks
- Тип: integer | null Формат: int64tasks
_error число задач в массиве tasks, возвращённых с ошибкой
- Тип: string | nulltime
общее время выполнения, секунды
- Тип: string | nullversion
текущая версия API
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/amazon/bulk_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"buy laptop",
"cheap laptops for sale",
"purchase laptop"
],
"location_code": 2840,
"language_code": "en"
}
]'
{
"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": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword": null,
"search_volume": null
}
]
}
]
}
]
}