Piloterr

Bing Search

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

Credit cost: 1 credit per call

GET
/v2/bing/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

The search query to execute on Bing. Supports all Bing advanced search operators.

Examples:

  • artificial intelligence — standard keyword search
  • site:github.com python scraper — restrict results to a specific domain
  • intitle:"machine learning" — match the page title
  • inurl:blog python — match part of the URL

Example:

artificial intelligence news 2024
page?number

Page number of results to retrieve. Used for pagination.

  • 1: First page (default)
  • 2: Second page
  • 3: Third page, etc.
num?number

Number of results per page. Minimum: 10, Maximum: 50.

Note: This parameter is only a suggestion and might not reflect the actual number of results returned.

location?string

City or region from which the search should originate. If multiple locations match, the most popular one is selected.

Note: Cannot be used together with lat/lon. It is recommended to specify location at the city level.

Example:

Austin
lat?number

GPS latitude coordinate for the search origin.

Example:

48.8566
lon?number

GPS longitude coordinate for the search origin.

Example:

2.3522
mkt?string

Market code combining language and country, in the form <language>-<country>. Defines where the results come from.

  • en-US: English, United States (default)
  • fr-FR: French, France
  • de-DE: German, Germany
  • es-ES: Spanish, Spain

Note: Cannot be used together with cc.

cc?string

Two-letter ISO 3166-1 country code defining the country to search from.

  • us: United States
  • de: Germany
  • gb: United Kingdom
  • fr: France

Note: Cannot be used together with mkt.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/bing/search?query=string"

{
  "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
  }
}

{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}

Bestbuy Search GET

Précédent

Brave Search GET

Suivant