Инструкция по Google API

Google API: Новости — Поиск по запросу

Находите объекты сущности «Новости» в Google по пользовательскому запросу и подключайте результаты к поиску, каталогу или исследовательскому интерфейсу.

Операция «Поиск по запросу» нужна, когда точный ID объекта ещё неизвестен и сначала требуется найти подходящие результаты.

Метод GET
Сущность Новости
Версии 1
Что делает этот эндпоинт

Что можно сделать с этим API-методом

Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.

Результат запроса

Ответ содержит найденные объекты «Новости», их публичный контекст и данные для продолжения поиска, если доступна пагинация.

Когда использовать

Операция «Поиск по запросу» нужна, когда точный ID объекта ещё неизвестен и сначала требуется найти подходящие результаты.

Типовые сценарии использования

Поиск в продукте

Добавляйте поиск по данным Google в клиентский или внутренний интерфейс.

Формирование каталога

Находите кандидатов по запросам и сохраняйте релевантные объекты для дальнейшего обогащения.

Исследование рынка

Собирайте поисковую выдачу для анализа тем, авторов и конкурентного окружения.

Доступные версии

Версия ответа

Обе версии решают одну и ту же задачу и принимают одинаковые параметры. Переключатель нужен, чтобы сравнить структуру ответа и выбрать версию, которую ожидает ваш клиент.

Версия ответа V2

Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.

V1 Недоступно

Что остается одинаковым

Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.

Что меняется между версиями

Главное отличие — envelope ответа. Для новых интеграций лучше использовать V2, а V1 оставлять только для совместимости с уже существующей клиентской интеграцией.

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

Как вызвать метод

Для обеих версий используется один заголовок API-ключа и одинаковые параметры строки запроса. Ниже сначала показаны общие параметры, затем путь и примеры кода для выбранной версии.

Входные параметры

Общие параметры
Параметр Обязателен Тип Пример Описание
country_code Нет str US Two-letter country code used for geo-localized Google results. Example: US.
date_range Нет str | None value Optional Google date range filter. Examples: 1d, 7d, 30d, 365d.
exclude_words Нет str | None value Optional words to exclude from Google News results. Example: jobs careers.
has_words Нет str | None value Optional extra words that must appear in Google News results. Example: artificial intelligence.
language Нет str | None value Optional Google interface language code used for localized text fields. Example: en.
query Нет str coffee shops Поисковый запрос пользователя.
website Нет str | None value Optional website domain filter. Example: microsoft.com.

Путь запроса для выбранной версии

V2

Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.

GET /api/v2/google.com/news/search-by-query

Нормализованный формат

Примеры кода

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/google.com/news/search-by-query" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  # Optional parameters:
  # --data-urlencode 'country_code=US'
  # --data-urlencode 'date_range=value'
  # --data-urlencode 'exclude_words=value'
  # --data-urlencode 'has_words=value'
  # --data-urlencode 'language=value'
  # --data-urlencode 'query=coffee shops'
  # --data-urlencode 'website=value'
Пример ответа

Пример ответа по версиям

Пример сокращён до ключевых полей и первых элементов коллекций, чтобы структуру ответа можно было быстро оценить. Переключатель версии меняет формат JSON.

Пример ответа

V2 — JSON

Проверенный пример

Компактный JSON-пример сформирован из последней успешной проверки версии V2.

{
  "success": true,
  "status": "ok",
  "search_context": {
    "date_range": "7d",
    "website": "microsoft.com",
    "language": "en",
    "country_code": "US",
    "query": "technology"
  },
  "data": {
    "articles": {
      "count": 100,
      "items": [
        {
          "title": "A blueprint for Australia’s success in the AI era - Microsoft Source",
          "news_url": "https://news.google.com/rss/articles/CBMioAFBVV95cUxOSkRQa0IxVDV5U1B3OHpKbGxXWDJlRzF4TnUtelA3TmlvdXpwaTlVUjJhSjgxTkVDMFlVN2NPa2NrVXVNeXhweFlGNV83TzZMSnc5ODNCck43cUlObjN2ODh4djFN…",
          "source_name": "Microsoft Source",
          "source_url": "https://news.microsoft.com",
          "published_at": "Wed, 15 Jul 2026 04:12:33 GMT",
          "description": "A blueprint for Australia’s success in the AI era Microsoft Source"
        },
        {
          "title": "DTS Sound Unbound - Free download and install on Windows - Microsoft Store",
          "news_url": "https://news.google.com/rss/articles/CBMibkFVX3lxTE96VHp5LW5PdEs0OFkzWXd6bU1GVzF6RDFiV25GNkExV19zYlNESFAtc2NpakhIXzZpRnMzY0xXOUE1M2ZHOUFGbjdrUW9xSllQcUk1cFZlMlYzcXE0WEl1eUJla294…",
          "source_name": "Microsoft Store",
          "source_url": "https://apps.microsoft.com",
          "published_at": "Fri, 17 Jul 2026 07:00:00 GMT",
          "description": "DTS Sound Unbound - Free download and install on Windows Microsoft Store"
        },
        {
          "_more_items": 98
        }
      ]
    }
  }
}
Что делать дальше

Продолжить оценку API-метода

Используйте инструкцию как первую точку принятия решения, а затем переходите к покрытию, стоимости и общим правилам интеграции перед запуском API-метода.

Открыть страницу Google API

Сравните соседние сущности, группы API-методов и связанные инструкции перед внедрением.

Открыть страницу платформы

Сравнить стоимость API-методов

Посмотрите, где этот API-метод находится в публичной таблице цен, прежде чем масштабировать использование.

Открыть тарифы

Проверить правила интеграции

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

Открыть документацию
FAQ

Вопросы, которые команды задают до внедрения

Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.

Какие данные возвращает этот метод Google API?

Метод выполняет операцию «Поиск по запросу» для сущности «Новости». Точный набор полей показан в компактном примере ответа ниже.

Какую версию ответа выбрать: V1 или V2?

Для новой интеграции выбирайте V2 с нормализованной структурой. V1 нужен только для совместимости с клиентами, которые уже используют исходный формат платформы.

Что нужно для первого запроса?

Создайте API-ключ, передайте его в заголовке и заполните обязательные параметры из таблицы. Готовые примеры кода уже содержат правильный путь и структуру запроса.