Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия SERP: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Выполните веб-поиск и получите ранжированные результаты с заголовком, URL, сниппетом, позицией и датой публикации. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API SERP?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Выполните веб-поиск и получите ранжированные результаты с заголовком, URL, сниппетом, позицией и датой публикации. Изображение и дополнительные ссылки возвращаются, если они есть. | keyword | country, language | Режим выдачи: Sync | Значение в каталоге: maxLimit=10. Прежде чем считать его итоговым количеством записей, проверьте примечания к действию. Можно передать большее значение limit, но оно будет ограничено значением 10. | $1.39 за 1 000 запросов | title · url · text · rank · published_at · image_url · sub_links |
Что означают параметры действия search в API SERP?
Выполните веб-поиск и получите ранжированные результаты с заголовком, URL, сниппетом, позицией и датой публикации. Изображение и дополнительные ссылки возвращаются, если они есть. country и language задают предпочтения, но не гарантируют, что им соответствует каждый результат. Страницы целиком не загружаются, а published_at может отсутствовать или быть неверным.
keywordОбязательный- Выражение поискового запроса для веб-поиска. Возвращает заголовки, URL и сниппеты результатов; полное содержимое найденных страниц не загружается, фильтрации по названию платформы нет.Google: сниппет в выдаче не равен тексту исходной страницы — Google определяет сниппеты как описания или краткие выдержки в результатах поиска и отмечает, что они могут динамически меняться в зависимости от запроса или браться из мета-описания страницы. Текст, который возвращает это действие, не является полным текстом целевой страницы; при цитировании фактов нужно напрямую проверять исходные страницы. · Проверено
countryНеобязательный- Предпочтительная страна или регион для результатов поиска, код вроде us. Влияет на географическую релевантность, а не на местоположение вызывающего сервера, и не гарантирует, что каждый результат относится к этой стране.
languageНеобязательный- Предпочтительный язык интерфейса поиска и результатов, например en или zh-cn. Содержимое возвращаемых страниц не переводится.
Как использовать API SERP
- 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":"web","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API SERP
Какие данные можно получить через API SERP?
Укажите в platform значение web. В текущем каталоге: поиск. Эти названия действий соответствуют разным объектам или представлениям SERP; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе SERP?
Выражение поискового запроса для веб-поиска. Возвращает заголовки, URL и сниппеты результатов; полное содержимое найденных страниц не загружается, фильтрации по названию платформы нет. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе SERP?
Объявленная схема включает title, text, rank и published_at. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия SERP возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.