---
title: "Search Bing news results"
method: GET
path: "/bing/news"
tags: ["Bing"]
---

# Search Bing news results

`GET /bing/news`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/bing/news`
- Auth: API key in header `x-api-key`

Returns Bing news search results for a query string. Locale defaults to country=us and lang=en-us. Returns 503 when Bing serves a challenge page or unusable results.

## Query parameters

- `q` string, required
- `page` integer
- `count` integer
- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BingNewsResponseDoc
  - `code` integer
  - `data` BingNewsResponse
    - `pagination` BingSearchPagination
      - `count` integer: Number of results requested per page.
      - `next_page` integer: Page number of the next page. Omitted when there is no next page.
      - `page` integer: Page number of this response, starting at 1.
      - `previous_page` integer: Page number of the previous page. Omitted on the first page.
    - `results` BingNewsResult[]: News results in Bing's order.
      - `age` string: How long ago the article was published, as Bing shows it.
      - `age_timestamp` integer: Publication time of the article as Unix seconds in UTC. Omitted when it cannot be worked out from `age`.
      - `description` string: Article snippet as shown on the Bing results page.
      - `position` integer: Rank of the article in the news block, starting at 1.
      - `related_count` integer: Number of additional relevant news articles Bing groups with this story.
      - `source` string: Name of the publication, for example `Reuters`.
      - `thumbnail` string: URL of the article thumbnail.
      - `title` string: Article headline as shown on the Bing results page.
      - `url` string: URL of the news article.
  - `msg` string

## Other responses

- `400`: Missing or invalid query parameters
- `404`: No results found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: Bing upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)