seo/
google-news

Собирает статьи Google News о компании, продукте или теме на любом рынке — с заголовком, фрагментом, изданием, временем публикации, миниатюрой и прямой ссылкой на страницу издания.

Google News API

Главные новости первыми
Прямые ссылки на издания
Время публикации
Любая страна и язык
0,1 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Google News

Google News собирает материалы новостных изданий и ранжирует их для каждого поиска, ставя карусель главных новостей над более широким списком статей; в каждом результате есть заголовок, фрагмент, издание и время публикации. Если следить за этими результатами по компании, продукту или теме, видно, кто о них пишет, как быстро новость расходится по изданиям и чем различается освещение в разных странах, — это сырье для мониторинга СМИ, оповещений о конкурентах и ежедневных новостных дайджестов.

Возможности Google News API

  • Ссылки прямо на статьюurl ведет на статью на сайте издания — её можно открыть, сохранить или переслать без перехода по ссылке Google.
  • Главные новости отмечены отдельноsection помечает каждую статью как top_stories или news, а rank сохраняет порядок Google с каруселью главных новостей в начале.
  • Издание и время публикации у каждой статьиsource называет издание, domain — его сайт, published_at — время выхода статьи, что удобно для сортировки и фильтрации.
  • Заголовок, фрагмент и миниатюраtitle и text содержат заголовок и фрагмент под ним, а image_url дает миниатюру статьи, если она общедоступна.
  • Любой рынок, до 200 статейВыберите страну и язык поиска и задайте results_limit от 1 до 200 статей на запрос.

Параметры Google News API

ПараметрыОбязательныйОписание
queryОбязательныйНовостной запрос: компания, продукт, человек или тема.
location_codeНеобязательныйКод локации новостного рынка. По умолчанию 2840 (США).
location_nameНеобязательныйНазвание рынка вместо location_code. Если заполнено, используется вместо location_code.
language_codeНеобязательныйКод языка новостей. По умолчанию en.
languageНеобязательныйНазвание языка вместо language_code. Если заполнено, используется вместо language_code.
results_limitНеобязательныйМаксимальное число статей от 1 до 200. По умолчанию 10.

Как использовать Google News API

Отправьте поисковый запрос и получите по строке на статью.

  1. Отправьте {"query": "nvidia", "location_code": 2840, "language_code": "en", "results_limit": 10} методом POST на /v1/seo/google-news.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте статьи из results.items в порядке rank и запрашивайте следующую страницу через results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/seo/google-news" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"nvidia","location_code":2840,"language_code":"en","results_limit":10}'

Сценарии использования Google News API

  • Мониторинг публикаций о бренде: Регулярно запрашивайте название бренда, храните url уже просмотренных статей и оповещайте о новых вместе с source и published_at.
  • Отслеживание запусков и анонсов конкурентов: Запрашивайте названия конкурентов и их продуктовых линеек, чтобы видеть, какие издания подхватывают их новости и как быстро.
  • Ежедневный новостной дайджест: Каждое утро собирайте top_stories по набору отраслевых тем и отправляйте заголовок, фрагмент и ссылку в командный канал или рассылку.
  • Сравнение освещения по странам: Запустите один запрос на нескольких рынках и посмотрите, какие новости расходятся по миру, а какие остаются локальными.

Практические советы по Google News API

  • Если нужны только главные новости, фильтруйте по section top_stories, а не увеличивайте results_limit.
  • Для удаления дублей между запусками используйте url как ключ: это адрес самой статьи и одновременно id строки.
  • Если название неоднозначно, добавьте в query уточнение — отрасль или продукт компании, — чтобы отсеять посторонние новости.

Помимо Google News API, используйте эти API, когда нужен другой тип публичных данных SEO.

  • Google Organic SERP API — Получайте одну актуальную страницу выдачи Google по запросу и рынку: нормализованные целевые URL, позиции, типы элементов и полные данные результатов.
  • Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
  • Keyword Overview API — Дополняйте пакет ключевых слов доступными данными о спросе, конкуренции в платной выдаче, сложности, ежемесячной частотности и интенте.
  • Keyword Search Volume API — Измеряйте известные ключевые слова: доступная частотность, CPC, конкуренция в платной выдаче и история частотности по месяцам.
  • Keywords for Site API — Подбирайте ключевые слова, релевантные одному сайту, с доступными данными о спросе, помесячной историей, контекстом рынка и полными исходными строками.
  • Google Autocomplete API — Собирайте подсказки, которые Google предлагает для начала запроса, в порядке Google, для любой страны и языка.

Другие платформы

Объединяйте данные SEO с публичными данными других поддерживаемых соцсетей.

Google News API — FAQ

Google News API возвращает статьи Google News по запросу для выбранной страны и языка; у каждой есть заголовок, фрагмент, издание, домен, время публикации, миниатюра и прямая ссылка на статью.

url ведет на статью на сайте издания, её можно сразу открыть или сохранить.

section показывает, где Google вывел статью: top_stories — карусель главных новостей, news — основной список. В rank главные новости идут первыми.

results_limit принимает значения от 1 до 200, по умолчанию 10.

Каждая возвращенная статья стоит 0,1 кредита.