POST
/
api
/
v2
/
bing
/
search
curl --request POST \
  --url https://piloterr.com/api/v2/bing/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "query": "<string>",
  "page": 123,
  "num": 123,
  "location": "<string>",
  "lat": 123,
  "lon": 123,
  "mkt": "<string>",
  "cc": "<string>"
}'
{
    "pagination": {
        "next": 2,
        "current": 1,
        "other_pages": [
            2,
            3,
            4
        ],
        "has_next_page": true
    },
    "organic_results": [
        {
            "date": "Apr 25, 2024",
            "link": "https://codycrossanswers.net/",
            "title": "CodyCross Answers Cheats and Solutions (2025)",
            "domain": "codycrossanswers.net",
            "snippet": "CodyCross Answers Cheats and Solutions.CodyCross is a famous newly released game which is developed by Fanatee. It has many crosswords divided",
            "position": 1,
            "displayed_link": "https://codycrossanswers.net",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/",
            "title": "Cross Validated",
            "domain": "stats.stackexchange.com",
            "snippet": "Q&A for people interested in statistics, machine learning, data analysis, data mining, and data visualization",
            "position": 2,
            "displayed_link": "https://stats.stackexchange.com",
            "snippet_matched": []
        },
        {
            "link": "https://help.hbomax.com/be/Answer/Detail/000004557",
            "title": "Activate your HBO Max Subscription",
            "domain": "help.hbomax.com",
            "snippet": "New subscription?: If you recently signed up for HBO Max (or HBO) through an internet, mobile, or TV provider, you need to activate HBO Max before you can start streaming Max. Here's …",
            "position": 3,
            "displayed_link": "https://help.hbomax.com › be › Answer › Detail",
            "snippet_matched": []
        },
        {
            "link": "https://help.hbomax.com/be/Category/Detail/Account_Sign_In",
            "title": "HBO Max | Help Center",
            "domain": "help.hbomax.com",
            "snippet": "© 2024 Discovery Communications Benelux B.V. All rights reserved. HBO Max is used under license.Pype - Conversation interface",
            "position": 4,
            "displayed_link": "https://help.hbomax.com › be › Category › Detail › Account_Sign_In",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/questions/65942/how-and-when-to-use-the-bonferroni-adjustment",
            "title": "How and when to use the Bonferroni adjustment",
            "domain": "stats.stackexchange.com",
            "snippet": "I have two questions regarding when to use a Bonferroni adjustment: Is it appropriate to use a Bonferroni adjustment in all cases of multiple testing? If one performs a test on a data set, then …",
            "position": 5,
            "displayed_link": "https://stats.stackexchange.com › questions",
            "snippet_matched": []
        },
        {
            "link": "https://help.hbomax.com/be/Answer/Detail/000004511",
            "title": "Download HBO Max shows and movies",
            "domain": "help.hbomax.com",
            "snippet": "Here's the number of downloads your account can have at one time (across all devices) for each base subscription plan.",
            "position": 6,
            "displayed_link": "https://help.hbomax.com › be › Answer › Detail",
            "snippet_matched": []
        },
        {
            "date": "May 6, 2011",
            "link": "https://stats.stackexchange.com/questions/10433/calculating-mean-age-from-grouped-census-data",
            "title": "Calculating mean age from grouped census data - Cross Validated",
            "domain": "stats.stackexchange.com",
            "snippet": "I hope you can help me with a question regarding calculating mean age from grouped census data. If the age categories used were [0–4], [5–9], [10–14], and [15–19] years, …",
            "position": 7,
            "displayed_link": "https://stats.stackexchange.com › questions",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/questions/3275/probability-of-game-outcomes-with-ties",
            "title": "Probability of Game Outcomes (with ties!) - Cross Validated",
            "domain": "stats.stackexchange.com",
            "snippet": "Based on these numbers, what is the probability of each outcome? The possible outcomes (W-L-T) would be: 2-0-0 1-1-0 1-0-1 0-1-1 0-2-0 0-0-2 Obviously this is pretty trivial with 2 games, but …",
            "position": 8,
            "displayed_link": "https://stats.stackexchange.com › questions",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/questions/91970/chi-square-test-difference-between-goodness-of-fit-test-and-test-of-independenc",
            "title": "Chi-square test: difference between goodness-of-fit test and test …",
            "domain": "stats.stackexchange.com",
            "snippet": "A goodness of fit test is for testing whether a set of multinomial counts is distributed according to a prespecified (i.e. before you see the data!) set of population proportions. A test of homogeneity …",
            "position": 9,
            "displayed_link": "https://stats.stackexchange.com › questions › chi-square-test-differenc…",
            "snippet_matched": []
        }
    ],
    "search_parameters": {
        "q": "home",
        "cc": "us",
        "lat": 49.951529,
        "lon": -98.936927,
        "mkt": null,
        "num": null,
        "page": 1,
        "engine": "bing",
        "location": "austin",
        "bing_domain": "bing.com"
    }
}
​
x-api-key
string
required

This parameter specifies the private key you’ll need for Piloterr access.

​
Body

​
Search Query

​
query
string
required

Parameter defines the query you want to search. You can use anything that you would use in a regular Bing search. e.g. inurl:, site:, intitle:.

​
Pagination and Results

​
page
integer

Parameter defines the result offset. It skips the given number of results. It’s used for pagination.

​
num
integer

Parameter controls the number of results per page. Minimum: 10, Maximum: 50. This parameter is only a suggestion and might not reflect actual results returned.

​
Geographic Location

​
location
string

Parameter defines from where you want the search to originate. If several locations match the location requested, we’ll pick the most popular one. Head to the Locations API if you need more precise control. Cannot be used together with uule. It is recommended to specify location at the city level to simulate a real user’s search.

​
lat
number

Defines a GPS latitude for the search origin.

​
lon
number

Defines a GPS longitude for the search origin.

​
Localization

​
mkt
string

The market where the results come from (e.g. en-US). Typically, mkt is the country where the user is making the request from. Must be in the form <language code>-<country code>. Cannot be used together with cc.

​
cc
string

Parameter defines the country to search from. It follows the 2-character ISO_3166-1 format (e.g., us for United States, de for Germany, gb for United Kingdom). Cannot be used together with mkt.

​
Response

​
Bing Search
object
{
    "pagination": {
        "next": 2,
        "current": 1,
        "other_pages": [
            2,
            3,
            4
        ],
        "has_next_page": true
    },
    "organic_results": [
        {
            "date": "Apr 25, 2024",
            "link": "https://codycrossanswers.net/",
            "title": "CodyCross Answers Cheats and Solutions (2025)",
            "domain": "codycrossanswers.net",
            "snippet": "CodyCross Answers Cheats and Solutions.CodyCross is a famous newly released game which is developed by Fanatee. It has many crosswords divided",
            "position": 1,
            "displayed_link": "https://codycrossanswers.net",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/",
            "title": "Cross Validated",
            "domain": "stats.stackexchange.com",
            "snippet": "Q&A for people interested in statistics, machine learning, data analysis, data mining, and data visualization",
            "position": 2,
            "displayed_link": "https://stats.stackexchange.com",
            "snippet_matched": []
        },
        {
            "link": "https://help.hbomax.com/be/Answer/Detail/000004557",
            "title": "Activate your HBO Max Subscription",
            "domain": "help.hbomax.com",
            "snippet": "New subscription?: If you recently signed up for HBO Max (or HBO) through an internet, mobile, or TV provider, you need to activate HBO Max before you can start streaming Max. Here's …",
            "position": 3,
            "displayed_link": "https://help.hbomax.com › be › Answer › Detail",
            "snippet_matched": []
        },
        {
            "link": "https://help.hbomax.com/be/Category/Detail/Account_Sign_In",
            "title": "HBO Max | Help Center",
            "domain": "help.hbomax.com",
            "snippet": "© 2024 Discovery Communications Benelux B.V. All rights reserved. HBO Max is used under license.Pype - Conversation interface",
            "position": 4,
            "displayed_link": "https://help.hbomax.com › be › Category › Detail › Account_Sign_In",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/questions/65942/how-and-when-to-use-the-bonferroni-adjustment",
            "title": "How and when to use the Bonferroni adjustment",
            "domain": "stats.stackexchange.com",
            "snippet": "I have two questions regarding when to use a Bonferroni adjustment: Is it appropriate to use a Bonferroni adjustment in all cases of multiple testing? If one performs a test on a data set, then …",
            "position": 5,
            "displayed_link": "https://stats.stackexchange.com › questions",
            "snippet_matched": []
        },
        {
            "link": "https://help.hbomax.com/be/Answer/Detail/000004511",
            "title": "Download HBO Max shows and movies",
            "domain": "help.hbomax.com",
            "snippet": "Here's the number of downloads your account can have at one time (across all devices) for each base subscription plan.",
            "position": 6,
            "displayed_link": "https://help.hbomax.com › be › Answer › Detail",
            "snippet_matched": []
        },
        {
            "date": "May 6, 2011",
            "link": "https://stats.stackexchange.com/questions/10433/calculating-mean-age-from-grouped-census-data",
            "title": "Calculating mean age from grouped census data - Cross Validated",
            "domain": "stats.stackexchange.com",
            "snippet": "I hope you can help me with a question regarding calculating mean age from grouped census data. If the age categories used were [0–4], [5–9], [10–14], and [15–19] years, …",
            "position": 7,
            "displayed_link": "https://stats.stackexchange.com › questions",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/questions/3275/probability-of-game-outcomes-with-ties",
            "title": "Probability of Game Outcomes (with ties!) - Cross Validated",
            "domain": "stats.stackexchange.com",
            "snippet": "Based on these numbers, what is the probability of each outcome? The possible outcomes (W-L-T) would be: 2-0-0 1-1-0 1-0-1 0-1-1 0-2-0 0-0-2 Obviously this is pretty trivial with 2 games, but …",
            "position": 8,
            "displayed_link": "https://stats.stackexchange.com › questions",
            "snippet_matched": []
        },
        {
            "link": "https://stats.stackexchange.com/questions/91970/chi-square-test-difference-between-goodness-of-fit-test-and-test-of-independenc",
            "title": "Chi-square test: difference between goodness-of-fit test and test …",
            "domain": "stats.stackexchange.com",
            "snippet": "A goodness of fit test is for testing whether a set of multinomial counts is distributed according to a prespecified (i.e. before you see the data!) set of population proportions. A test of homogeneity …",
            "position": 9,
            "displayed_link": "https://stats.stackexchange.com › questions › chi-square-test-differenc…",
            "snippet_matched": []
        }
    ],
    "search_parameters": {
        "q": "home",
        "cc": "us",
        "lat": 49.951529,
        "lon": -98.936927,
        "mkt": null,
        "num": null,
        "page": 1,
        "engine": "bing",
        "location": "austin",
        "bing_domain": "bing.com"
    }
}

Was this page helpful?