Google News Парсер

Создание задачи

Отправьте задачу парсинга Google News для получения статей и подборок по заданному типу ленты.

Требует области действия google-news для вашего API-ключа.

Эндпоинт

POST /api/parsing/v1/google-news

Тело запроса

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

Базовые поля (все ленты)

Параметр	Тип	Обязательный	Описание
feed	string	да	Тип ленты: `"search"`, `"topic"` или `"stories"`
gl	string	да	Код страны (например, `US`, `GB`)
hl	string	да	Код языка (например, `en`, `de`)
timeframe	string	да	Временной фильтр (например, `1d`, `7d`, `30d`)
limit	number	да	Количество статей для получения (мин.: `10`, макс.: `100`)
callbackUrl	string	нет	URL вебхука для отправки результата по завершении

`feed: "search"` — поиск по запросу

Параметр	Тип	Обязательный	Описание
q	string	да	Поисковый запрос

`feed: "topic"`, `by: "token"` — тема по токену

Параметр	Тип	Обязательный	Описание
by	string	да	Должно быть `"token"`
topicTitle	string	да	Человекочитаемое название темы (например, `Business`)
topicToken	string	нет	Токен темы из эндпоинта доступных тем

`feed: "topic"`, `by: "kgmid"` — тема по Knowledge Graph ID

Параметр	Тип	Обязательный	Описание
by	string	да	Должно быть `"kgmid"`
topicKgmid	string	да	Google Knowledge Graph ID (например, `/m/09s1f`)

`feed: "stories"` — подборка историй по токену

Параметр	Тип	Обязательный	Описание
storiesToken	string	да	Токен подборки историй (из `topicStories[].storiesToken` в результате темы)
storiesTitle	string	нет	Человекочитаемое название подборки историй

Примеры запросов

Лента поиска:

curl -X POST 'https://app.parsering.com/api/parsing/v1/google-news' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"gl":"US","hl":"en","timeframe":"1d","limit":10,"feed":"search","q":"Pizza"}'

Лента темы (по токену):

curl -X POST 'https://app.parsering.com/api/parsing/v1/google-news' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"gl":"US","hl":"en","timeframe":"1d","limit":10,"feed":"topic","by":"token","topicToken":"CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx6TVdZU0FtVnVHZ0pWVXlnQVAB","topicTitle":"Business"}'

Лента темы (по kgmid):

curl -X POST 'https://app.parsering.com/api/parsing/v1/google-news' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"gl":"US","hl":"en","timeframe":"1d","limit":10,"feed":"topic","by":"kgmid","topicKgmid":"/m/0k8z"}'

Лента историй:

curl -X POST 'https://app.parsering.com/api/parsing/v1/google-news' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"gl":"US","hl":"en","timeframe":"1d","limit":10,"feed":"stories","storiesToken":"CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2k1c2J2MUVSRWN0X3l1dFpkS3dpZ0FQAQ","storiesTitle":"Wall Street stocks"}'

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

{
  "id": "ac9c7911-b32c-4890-a850-227003ee2d35",
  "status": "parsing",
  "scope": "google-news",
  "costCredits": 1,
  "createdAt": "2026-09-03T10:00:00.000Z"
}

Поле	Тип	Описание
id	string	ID задачи для опроса результата
status	string	Текущий статус задачи (`parsing`, `done`, `error`)
scope	string	Тип задачи — всегда `google-news` для этого эндпоинта
costCredits	number	Количество кредитов, списанных за задачу
createdAt	string	Временная метка создания задачи в формате ISO 8601

Задача обрабатывается асинхронно. Используйте id для опроса результата или укажите callbackUrl для получения вебхука по завершении парсинга.

Следующие шаги

Получение результата — опрос результата по ID задачи
Вебхуки — получение результата через callback вместо опроса
Доступные темы — поиск токенов тем по странам
Тарифы — как рассчитываются кредиты для этого запроса