API Google News
Google News собирает статьи новостных изданий. search возвращает до 20 свежих статей по запросу с заголовком, ссылкой, изданием, сниппетом, временем публикации и изображением.
Результаты соответствуют региональной версии Google News, заданной country и language (по умолчанию us и en). Ограничить давность статей можно с помощью time_window. Ключевое слово поддерживает операторы поиска Google, например site:cnn.com, OR и -word. Вызов стоит одинаково для 1 и для 20 статей, а Google News иногда возвращает меньше запрошенного.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Google News: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите в Google News по keyword и получайте до 20 статей с заголовком, ссылкой, издателем, сниппетом, временем публикации и изображением. | $0.79 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Google News?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите в Google News по | keyword | country, language, time_window | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.79 за 1 000 запросов | rank · title · url · source · text · published_at · image_url · platform |
Что означают параметры действия search в API Google News?
Ищите в Google News по keyword и получайте до 20 статей с заголовком, ссылкой, издателем, сниппетом, временем публикации и изображением. Сужайте выдачу через country, language и time_window (час, день, неделя, месяц или год). В поисковом запросе поддерживаются такие операторы, как site:, OR и -.
keywordОбязательный- Поисковый запрос по новостям, например
OpenAI. Поддерживаются операторы Google:site:cnn.com,ORи-wordдля исключения слова. До 500 символов.Справка Google Поиска: операторы для уточнения поиска — В справке Google Поиска описаны операторы: `site:` ограничивает результаты одним сайтом, `-` исключает слова, а кавычки задают точную фразу; оператор и термин пишутся без пробела. Источник описывает только синтаксис поиска Google. Поддержка этих операторов в `keyword` этого API для Google News, а также фильтры `country`, `language` и `time_window` определены EveryInfra; источник не гарантирует результаты или их количество. · Проверено countryНеобязательный- Двухбуквенный код страны, например
us,gbилиde, для выпуска Google News, по которому ведётся поиск (по умолчаниюus). languageНеобязательный- Двухбуквенный код языка выпуска, например
en,esилиde(по умолчаниюen). time_windowНеобязательный- Только статьи за этот период:
hour,day,week,monthилиyear. Без параметра ограничения по времени нет.
Как использовать API Google News
- 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_news","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Google News
Какие данные можно получить через API Google News?
Укажите в platform значение google_news. В текущем каталоге: поиск. Эти названия действий соответствуют разным объектам или представлениям Google News; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Google News?
Поисковый запрос по новостям, например OpenAI. Поддерживаются операторы Google: site:cnn.com, OR и -word для исключения слова. До 500 символов. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Google News?
Объявленная схема включает rank, title, source и text. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Google News возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.