# Documentation de la SERP API | QuantumProxies.io

Référence de la SERP API : endpoints, paramètres et schéma de réponse pour les résultats Google, Bing et DuckDuckGo en JSON, avec exemples de code et démo.

## Documentation de la SERP API

Our Bing Search API allows you to scrape results from the Bing search page.

The API endpoint is `https://app.quantumproxies.io/api/v1/serp/bing`  
Every request needs your API key in the `Authorization` header, and each successful search is billed like a SERP API search with engine `bing`.  
Head to the [playground](https://quantumproxies.io/fr/serp-api) for a live and interactive demo.

## API Parameters

### Search Query

- `q` (required): Defines the search query. You can use anything that you would use in a regular Bing search (e.g. `'query'`, `NOT`, `OR`, `site:`, `filetype:`, `near:`).

### Search Type

- `search_type` (optional): The Bing vertical to search: `search` (default), `shopping`, `images`, `news`, `videos`, `places`, `maps` or `autocomplete`.

### Localization

- `cc` (optional): Defines the country to search from. It follows the 2-character [ISO_3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) format (e.g., `us`, `de`, `gb`, `it`). It sets both the Bing market and the country of the IP the search goes out from.
- `lang` (optional): Language of the Bing interface (e.g. `en`, `it`).

### Pagination

- `page` (optional): Result page, starting from `1` (default). Request one page at a time and read `payload.pagination` for the pages that exist.

### Device

- `device` (optional): The device to search as: `desktop` (default) gets the computer page; `mobile`, `ios` and `android` get the phone page.

### Authentication

- `Authorization` (required): Your QuantumProxies API key as a Bearer token, in the request header: `Authorization: Bearer YOUR_API_KEY`. A request without a valid, active key gets `401` and no results.

## API Results

### JSON Results

Every answer has the envelope of the rest of the API: `type` (`response` or `error`), `message`, and the search under `payload`.

`payload` holds `search_metadata`, `search_parameters`, `organic`, `ads`, `knowledge_graph`, `related_searches`, `pagination` and the other blocks Bing shows for the query; a block Bing does not show comes back empty (`null` or `[]`). `payload.usage` says what the call cost.

### Billing and Errors

Each successful search is billed like a [SERP API](https://app.quantumproxies.io/api-docs#scraper-serp) search with engine `bing`. When Bing blocks a search, the answer is `429` and the search costs nothing.

A missing, invalid or disabled key answers `401`; a balance too low for the search answers `402`. Errors carry `type: "error"` and the reason in `message`.

## Result sections

### Ad Results

Sponsored results in ads: title, landing link, display link, and whether they sit above or below the organic list.

### Answer Box

Instant answers (calculator, dictionary, facts) in answer_box, the featured snippet with its source, and the Copilot answer in ai_overview.

### Inline Images

Image results in images (search_type images): title, image, thumbnail and the page it comes from.

### Inline Shopping Results

Product listings in shopping (search_type shopping): title, price, seller, rating and link.

### Inline Videos

Video results in inline_videos: title, link, platform, channel, date and duration.

### Knowledge Graph

The entity panel in knowledge_graph: title, type, description, source, images and attributes.

### Organic Results

The ranked results in organic: rank, title, link, display link, source and description, with date, sitelinks and rich snippet facts where Bing shows them.

### Related Searches

Bing's related queries in related_searches (query and link), and people_also_ask where Bing shows it.

### Pagination

pagination: the current page, the next page number, has_next and other_pages, a map of page numbers to Bing URLs.

## Ready to start scraping Bing?

Try the live playground or get your API key.
