# Bing Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/bing/search` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/bing-search |

## Description

Scrape real-time Bing search results with full control over location, language, and pagination.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/bing/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'artificial intelligence'

```json
{
  "pagination": {
    "next": null,
    "current": 1,
    "other_pages": [],
    "has_next_page": false
  },
  "organic_results": [
    {
      "link": "https://en.m.wikipedia.org/wiki/Artificial_intelligence",
      "title": "Artificial intelligence - Wikipedia",
      "domain": "en.m.wikipedia.org",
      "snippet": null,
      "position": 1,
      "displayed_link": "https://en.m.wikipedia.org › wiki ›Artificial_intelligence",
      "snippet_matched": []
    },
    {
      "link": "https://www.britannica.com/technology/artificial-intelligence",
      "title": "Artificial intelligence (AI) | Definition, Examples, Types ...",
      "domain": "britannica.com",
      "snippet": null,
      "position": 2,
      "displayed_link": "https://www.britannica.com › technology ›artificial-intelligence",
      "snippet_matched": []
    },
    {
      "link": "https://www.ibm.com/think/topics/artificial-intelligence",
      "title": "What is artificial intelligence (AI)? - IBM",
      "domain": "ibm.com",
      "snippet": "Artificial intelligence (AI) is technology that enables computers and machines to simulate human learning, comprehension, problem solving, decision-making, creativity and autonomy.",
      "position": 3,
      "displayed_link": "https://www.ibm.com › think › topics ›artificial-intelligence",
      "snippet_matched": [
        "artificial intelligence"
      ]
    }
  ],
  "search_parameters": {
    "q": "artificial intelligence",
    "cc": null,
    "lat": null,
    "lon": null,
    "mkt": null,
    "num": null,
    "page": 1,
    "engine": "bing",
    "location": null,
    "bing_domain": "bing.com"
  },
  "search_information": {
    "total_results": null
  }
}
```

### Search 'python tutorial' with market 'en-US'

```json
{
  "pagination": {
    "next": null,
    "current": 1,
    "other_pages": [],
    "has_next_page": false
  },
  "organic_results": [
    {
      "link": "https://docs.python.org/3/tutorial/index.html",
      "title": "The Python Tutorial. Python 3.14.3 documentation",
      "domain": "docs.python.org",
      "snippet": null,
      "position": 1,
      "displayed_link": "https://docs.python.org ›tutorial",
      "snippet_matched": []
    },
    {
      "link": "https://www.tutorialspoint.com/python/index.htm",
      "title": "Python Tutorial",
      "domain": "tutorialspoint.com",
      "snippet": "This Python tutorial gives a complete understanding of Python programming language, starting from basic concepts to advanced concepts.",
      "position": 2,
      "displayed_link": "https://www.tutorialspoint.com ›python",
      "snippet_matched": [
        "python tutorial"
      ]
    },
    {
      "link": "https://www.learnpython.org/",
      "title": "Learn Python - Free Interactive Python Tutorial",
      "domain": "learnpython.org",
      "snippet": "Learn Python for data science, web development, or general programming with this website.",
      "position": 3,
      "displayed_link": "https://www.learnpython.org",
      "snippet_matched": []
    },
    {
      "link": "https://realpython.com/",
      "title": "Python Tutorials – Real Python",
      "domain": "realpython.com",
      "snippet": "Learn Python online: Python tutorials for developers of all skill levels, Python books and courses, Python news, code examples, articles, and more.",
      "position": 4,
      "displayed_link": "https://realpython.com",
      "snippet_matched": [
        "python tutorial"
      ]
    }
  ],
  "search_parameters": {
    "q": "python tutorial",
    "cc": null,
    "lat": null,
    "lon": null,
    "mkt": "en-US",
    "num": null,
    "page": 1,
    "engine": "bing",
    "location": null,
    "bing_domain": "bing.com"
  },
  "search_information": {
    "total_results": null
  }
}
```

## Documentation

## Overview
Scrape organic search results from Bing for any query. Supports advanced operators, geographic targeting, and pagination.

## Quickstart
```
POST https://api.piloterr.com/v2/bing/search
Content-Type: application/json

{"query": "artificial intelligence", "cc": "us"}
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The Bing search query |
| `page` | integer | no | Page number for pagination |
| `num` | integer | no | Results per page (min: 10, max: 50) |
| `location` | string | no | City-level location for geo-targeting |
| `lat` | number | no | GPS latitude |
| `lon` | number | no | GPS longitude |
| `mkt` | string | no | Market code e.g. `en-US` |
| `cc` | string | no | 2-letter country code e.g. `us` |

## Main use cases
- Monitor brand mentions and competitor rankings on Bing
- Build SERP tracking tools across markets and languages
- Aggregate multi-engine search results for SEO analysis
- Extract organic results for competitive research pipelines