# Basic API Requests Using the Bing Search API is a straightforward process. You send a GET request to our SERP API and return real time results in a JSON format. In order to scrape Bing via our SERP API, you only need to pass three required [parameters](/bing-search-api/getting-started/api-parameters.md) to your request: * `api_key` - Your [personal API key](/bing-search-api/getting-started/access-the-api.md#the-api-key), used to authenticate your requests * `engine` - always set to `bing` for this API * `q` - The keyword you are targeting The most basic URL example for an authorised request on our Bing API is: {% code overflow="wrap" %} ``` https://serpapi.webscrapingapi.com/v2?engine=bing&api_key=&q= ``` {% endcode %} {% hint style="info" %} Depending on your implementation, the `q` parameter's value should be URL encoded. {% endhint %} ### The Bing API Integration Examples {% tabs %} {% tab title="cURL" %} {% code overflow="wrap" %} ```bash curl --request GET --url "https://serpapi.webscrapingapi.com/v2?engine=bing&api_key=&q=shoes" ``` {% endcode %} {% endtab %} {% tab title="NodeJS" %} {% code overflow="wrap" %} ```javascript const http = require("https"); const options = { "method": "GET", "hostname": "serpapi.webscrapingapi.com", "port": null, "path": "/v2?engine=bing&api_key=YOUR_API_KEY&q=shoes", "headers": {} }; const req = http.request(options, function (res) { const chunks = []; res.on("data", function (chunk) { chunks.push(chunk); }); res.on("end", function () { const body = Buffer.concat(chunks); console.log(body.toString()); }); }); req.end(); ``` {% endcode %} {% endtab %} {% tab title="Python" %} {% code overflow="wrap" %} ```python import requests API_KEY = '' SCRAPER_URL = 'https://serpapi.webscrapingapi.com/v2' PARAMS = { "api_key":API_KEY, "engine":"bing", "q":"shoes" } response = requests.get(SCRAPER_URL, params=PARAMS) print(response.text) ``` {% endcode %} {% endtab %} {% tab title="PHP" %} {% code overflow="wrap" %} ```php "https://serpapi.webscrapingapi.com/v2?engine=bing&api_key=YOUR_API_KEY&q=shoes", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` {% endcode %} {% endtab %} {% tab title="Go" %} {% code overflow="wrap" %} ```go package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://serpapi.webscrapingapi.com/v2?engine=bing&api_key=YOUR_API_KEY&q=shoes" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` {% endcode %} {% endtab %} {% tab title="Java" %} {% code overflow="wrap" %} ```java HttpResponse response = Unirest.get("https://serpapi.webscrapingapi.com/v2?engine=bing&api_key=YOUR_API_KEY&q=shoes") .asString(); ``` {% endcode %} {% endtab %} {% tab title=".NET" %} {% code overflow="wrap" %} ```csharp var client = new RestClient("https://serpapi.webscrapingapi.com/v2?engine=bing&api_key=YOUR_API_KEY&q=shoes"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` {% endcode %} {% endtab %} {% tab title="Ruby" %} {% code overflow="wrap" %} ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://serpapi.webscrapingapi.com/v2?engine=bing&api_key=YOUR_API_KEY&q=shoes") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` {% endcode %} {% endtab %} {% endtabs %}
Response Example ``` { "general": { "search_engine": "bing", "query": "shoes", "results_cnt": 5780000, "country_code": "XL", "language": "es-ES", "mobile": false, "search_type": "text", "page_title": "shoes - Búsqueda", "timestamp": "2024-10-14T12:21:27.562Z" }, "top_ads": [ { "title": "Shop for Women's Shoes & more - Amazon.com® Official Site", "link": "https://www.amazon.com › Shop › WomensShoes", "referral_link": "https://www.bing.com/aclick?ld=e8Fv0_JLbSGpMnc55XsCgMIjVUCUwfTWf_THMPg2x_cKqadoAGDbJgWjCqjdR596HkiT3d9VYekvxdvyqhv_55z3iMJY7kieD7YIIYg_KliRM_NicxihldUjA6kZ2Gf_twx9sV9FH_AQ3Gg426qUyguLtBCq0on2-WS7GVmJEVaehiPYtIhAjEBnt6NaTQnQUAZdsEEw&u=aHR0cHMlM2ElMmYlMmZ3d3cuYW1hem9uLmNvbSUyZnMlMmYlM2ZpZSUzZFVURjglMjZrZXl3b3JkcyUzZHVnZyUyYnNsaXBwZXJzJTJiZm9yJTJid29tZW4lMmJ0YXNtYW4lMjZpbmRleCUzZGFwcyUyNnRhZyUzZG1oMGItMjAlMjZyZWYlM2RwZF9zbF82aHBkczlzNWhhX2IlMjZhZGdycGlkJTNkMTMzODEwODA1MjgzMDEzNSUyNmh2YWRpZCUzZDgzNjMyMDE2OTAwNTIzJTI2aHZuZXR3JTNkbyUyNmh2cW10JTNkYiUyNmh2Ym10JTNkYmIlMjZodmRldiUzZGMlMjZodmxvY2ludCUzZCUyNmh2bG9jcGh5JTNkMTQ1JTI2aHZ0YXJnaWQlM2Rrd2QtODM2MzI4MDQ1MDY5MzQlMjZoeWRhZGNyJTNkNzg3OV8xMzU4NDA2MyUyNm1zY2xraWQlM2Q2N2E4NjRhMDIwZDQxNTJlY2YxMzAzYWQyYzEyZjRmYQ&rlid=67a864a020d4152ecf1303ad2c12f4fa", "rank": 1, "global_rank": 1 }, { "title": "Sneackers Shoes on ebay - Seriously, We Have Sneackers Shoes", "link": "www.ebay.com", "referral_link": "https://www.bing.com/aclick?ld=e80dGkWHIWwy12iQc0-CPfsTVUCUzEpzVMmFbUNn4Kc4LP_cmC3qAC2xfYvtXpWfv7R0ITNxCdnOg3sHv-vFaglp3ZMnup2ttBEV83cALe2ZErQqmK9YcdtDi3ayIrt7lRlmTHABuZMCwVwK9CtqsmxGbPUV561kwK646QGP8keEdPWeLSqgBzmJUunQI9yoPiSj_Ejw&u=aHR0cHMlM2ElMmYlMmZ3d3cuZWJheS5jb20lMmZzY2glMmZpLmh0bWwlM2Zfbmt3JTNkc25lYWNrZXJzJTI1MjBzaG9lcyUyNm5vcm92ZXIlM2QxJTI2bWtldnQlM2QxJTI2bWtyaWQlM2Q3MTEtMzQwMDItMTMwNzgtMCUyNm1rY2lkJTNkMiUyNm1rc2NpZCUzZDEwMiUyNmtleXdvcmQlM2RzbmVhY2tlcnMlMjUyMHNob2VzJTI2Y3JscCUzZF81MDg3JTI2TVRfSUQlM2QlMjZnZW9faWQlM2QlMjZybHNhdGFyZ2V0JTNka3dkLTc2NTUzNjc2NzM2MTQwJTNhbG9jLTE0NSUyNmFkcG9zJTNkJTI2ZGV2aWNlJTNkYyUyNm1rdHlwZSUzZCUyNmxvYyUzZDE0NSUyNnBvaSUzZCUyNmFiY0lkJTNkJTI2Y21wZ24lM2QzOTU0MTc0MDElMjZzaXRlbG5rJTNkJTI2YWRncm91cGlkJTNkMTIyNDg1NjE2MDMxNjYyNCUyNm5ldHdvcmslM2RvJTI2bWF0Y2h0eXBlJTNkcCUyNm1zY2xraWQlM2RlYjBmN2EyMzY2MzcxMzc0NGMxMDFkMmU2YWYxMDJhYw&rlid=eb0f7a23663713744c101d2e6af102ac", "rank": 2, "global_rank": 2 } ], "bottom_ads": [ { "title": "Shop for Women's Shoes & more - Amazon.com® Official Site", "link": "https://www.amazon.com › Shop › WomensShoes", "referral_link": "https://www.bing.com/aclick?ld=e8Fv0_JLbSGpMnc55XsCgMIjVUCUwfTWf_THMPg2x_cKqadoAGDbJgWjCqjdR596HkiT3d9VYekvxdvyqhv_55z3iMJY7kieD7YIIYg_KliRM_NicxihldUjA6kZ2Gf_twx9sV9FH_AQ3Gg426qUyguLtBCq0on2-WS7GVmJEVaehiPYtIhAjEBnt6NaTQnQUAZdsEEw&u=aHR0cHMlM2ElMmYlMmZ3d3cuYW1hem9uLmNvbSUyZnMlMmYlM2ZpZSUzZFVURjglMjZrZXl3b3JkcyUzZHVnZyUyYnNsaXBwZXJzJTJiZm9yJTJid29tZW4lMmJ0YXNtYW4lMjZpbmRleCUzZGFwcyUyNnRhZyUzZG1oMGItMjAlMjZyZWYlM2RwZF9zbF82aHBkczlzNWhhX2IlMjZhZGdycGlkJTNkMTMzODEwODA1MjgzMDEzNSUyNmh2YWRpZCUzZDgzNjMyMDE2OTAwNTIzJTI2aHZuZXR3JTNkbyUyNmh2cW10JTNkYiUyNmh2Ym10JTNkYmIlMjZodmRldiUzZGMlMjZodmxvY2ludCUzZCUyNmh2bG9jcGh5JTNkMTQ1JTI2aHZ0YXJnaWQlM2Rrd2QtODM2MzI4MDQ1MDY5MzQlMjZoeWRhZGNyJTNkNzg3OV8xMzU4NDA2MyUyNm1zY2xraWQlM2Q2N2E4NjRhMDIwZDQxNTJlY2YxMzAzYWQyYzEyZjRmYQ&rlid=67a864a020d4152ecf1303ad2c12f4fa", "rank": 1, "global_rank": 13 }, { "title": "Sneackers Shoes on ebay - Seriously, We Have Sneackers Shoes", "link": "www.ebay.com", "referral_link": "https://www.bing.com/aclick?ld=e80dGkWHIWwy12iQc0-CPfsTVUCUzEpzVMmFbUNn4Kc4LP_cmC3qAC2xfYvtXpWfv7R0ITNxCdnOg3sHv-vFaglp3ZMnup2ttBEV83cALe2ZErQqmK9YcdtDi3ayIrt7lRlmTHABuZMCwVwK9CtqsmxGbPUV561kwK646QGP8keEdPWeLSqgBzmJUunQI9yoPiSj_Ejw&u=aHR0cHMlM2ElMmYlMmZ3d3cuZWJheS5jb20lMmZzY2glMmZpLmh0bWwlM2Zfbmt3JTNkc25lYWNrZXJzJTI1MjBzaG9lcyUyNm5vcm92ZXIlM2QxJTI2bWtldnQlM2QxJTI2bWtyaWQlM2Q3MTEtMzQwMDItMTMwNzgtMCUyNm1rY2lkJTNkMiUyNm1rc2NpZCUzZDEwMiUyNmtleXdvcmQlM2RzbmVhY2tlcnMlMjUyMHNob2VzJTI2Y3JscCUzZF81MDg3JTI2TVRfSUQlM2QlMjZnZW9faWQlM2QlMjZybHNhdGFyZ2V0JTNka3dkLTc2NTUzNjc2NzM2MTQwJTNhbG9jLTE0NSUyNmFkcG9zJTNkJTI2ZGV2aWNlJTNkYyUyNm1rdHlwZSUzZCUyNmxvYyUzZDE0NSUyNnBvaSUzZCUyNmFiY0lkJTNkJTI2Y21wZ24lM2QzOTU0MTc0MDElMjZzaXRlbG5rJTNkJTI2YWRncm91cGlkJTNkMTIyNDg1NjE2MDMxNjYyNCUyNm5ldHdvcmslM2RvJTI2bWF0Y2h0eXBlJTNkcCUyNm1zY2xraWQlM2RlYjBmN2EyMzY2MzcxMzc0NGMxMDFkMmU2YWYxMDJhYw&rlid=eb0f7a23663713744c101d2e6af102ac", "rank": 2, "global_rank": 14 } ], "organic": [ { "link": "https://metroshoes.com.pa/", "display_link": "https://metroshoes.com.pa", "title": "Home MetroShoes - Tienda oficial de Ropa y …", "rank": 1, "global_rank": 3 }, { "link": "https://www.bbb.com.pa/", "display_link": "https://www.bbb.com.pa", "title": "bbb Shoes & Boots", "description": "MujerHombreNiñasNiñosAccesoriosOFERTAS", "rank": 2, "global_rank": 4 }, { "link": "https://www.bbb.com.pa/mujer", "display_link": "https://www.bbb.com.pa › mujer", "title": "Zapatos para mujer, depor - bbb", "description": "WEBLuce a la moda sin esfuerzo con zapatos para mujer de diferentes estilos. Elige tus favoritos según la ocasión y lleva la originalidad contigo. Ingresa a BBB.", "rank": 3, "global_rank": 12 } ], "related": [ { "link": "https://www.bing.com/search?q=female+shoes&FORM=QSRE1", "text": "female shoes", "rank": 1, "global_rank": 15 }, { "link": "https://www.bing.com/search?q=shoes+women&FORM=QSRE2", "text": "shoes women", "rank": 2, "global_rank": 16 }, { "link": "https://www.bing.com/search?q=outdoor+shoes&FORM=QSRE3", "text": "outdoor shoes", "rank": 3, "global_rank": 17 }, { "link": "https://www.bing.com/search?q=famous+shoes&FORM=QSRE4", "text": "famous shoes", "rank": 4, "global_rank": 18 }, { "link": "https://www.bing.com/search?q=famous+footwear+official+website&FORM=QSRE5", "text": "famous footwear official website", "rank": 5, "global_rank": 19 }, { "link": "https://www.bing.com/search?q=shoes+online&FORM=QSRE6", "text": "shoes online", "rank": 6, "global_rank": 20 }, { "link": "https://www.bing.com/search?q=footwear+online+shop&FORM=QSRE7", "text": "footwear online shop", "rank": 7, "global_rank": 21 }, { "link": "https://www.bing.com/search?q=famous+footwear&FORM=QSRE8", "text": "famous footwear", "rank": 8, "global_rank": 22 } ], "images": [ { "link": "https://www.bing.com/images/search?q=shoes&id=D038C203DD8DB6280D77AE83180C295539982F49&FORM=IQFRBA", "image": "https://www.bing.com/th?id=OIP.ZxQM47KwVgtd2WpzealytQHaHa&w=171&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "image_alt": "Tamaño de Resultado de imágenes de Shoes.: 171 x 150. Fuente: www.gq.co.za", "image_url": "https://www.bing.com/th?id=OIP.ZxQM47KwVgtd2WpzealytQHaHa&w=171&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "rank": 1, "global_rank": 5 }, { "link": "https://www.bing.com/images/search?q=shoes&id=80900681399662C0D4693787824A6AC0701E7163&FORM=IQFRBA", "image": "https://www.bing.com/th?id=OIP._BwdoZP9-VyqLAj44k9EiwHaE8&w=248&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "image_alt": "Tamaño de Resultado de imágenes de Shoes.: 248 x 150. Fuente: www.pexels.com", "image_url": "https://www.bing.com/th?id=OIP._BwdoZP9-VyqLAj44k9EiwHaE8&w=248&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "rank": 2, "global_rank": 6 }, { "link": "https://www.bing.com/images/search?q=shoes&id=82F84DBAE26BE983890933347D88FBA8106DEDFC&FORM=IQFRBA", "image": "https://www.bing.com/th?id=OIP.mL9GqnkuX82xRnPyV7lvJAHaHa&w=173&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "image_alt": "Tamaño de Resultado de imágenes de Shoes.: 173 x 150. Fuente: www.etsy.com", "image_url": "https://www.bing.com/th?id=OIP.mL9GqnkuX82xRnPyV7lvJAHaHa&w=173&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "rank": 3, "global_rank": 7 }, { "link": "https://www.bing.com/images/search?q=shoes&id=1F4642575FEBCE65175995CBA87C104881C150D7&FORM=IQFRBA", "image": "https://www.bing.com/th?id=OIP.RBr0sduFas_PMPySBwZnjAHaHa&w=147&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "image_alt": "Tamaño de Resultado de imágenes de Shoes.: 147 x 150. Fuente: www.temu.com", "image_url": "https://www.bing.com/th?id=OIP.RBr0sduFas_PMPySBwZnjAHaHa&w=147&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "rank": 4, "global_rank": 8 }, { "link": "https://www.bing.com/images/search?q=shoes&id=2CEB7F55AE73C5A3F80980C7A675EC8BB1059F9C&FORM=IQFRBA", "image": "https://www.bing.com/th?id=OIP.iesP9V0PgiMHP0tElHTSSgAAAA&w=147&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "image_alt": "Tamaño de Resultado de imágenes de Shoes.: 147 x 150. Fuente: www.temu.com", "image_url": "https://www.bing.com/th?id=OIP.iesP9V0PgiMHP0tElHTSSgAAAA&w=147&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "rank": 5, "global_rank": 9 }, { "link": "https://www.bing.com/images/search?q=shoes&id=759A2EABE0B50FB913DF347F58890EF0B97D74DC&FORM=IQFRBA", "image": "https://www.bing.com/th?id=OIP.ht47OQS6uszuFVXeG3jRnAHaHa&w=147&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "image_alt": "Tamaño de Resultado de imágenes de Shoes.: 147 x 150. Fuente: tennisnuts.com", "image_url": "https://www.bing.com/th?id=OIP.ht47OQS6uszuFVXeG3jRnAHaHa&w=147&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "rank": 6, "global_rank": 10 }, { "link": "https://www.bing.com/images/search?q=shoes&id=C80EB43F32BD94B9B9BBF633B35DA80189F10D3B&FORM=IQFRBA", "image": "https://www.bing.com/th?id=OIP.YWLqzwgxHxFZSlDSM1uMtAHaHn&w=143&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "image_alt": "Tamaño de Resultado de imágenes de Shoes.: 143 x 150. Fuente: mungfali.com", "image_url": "https://www.bing.com/th?id=OIP.YWLqzwgxHxFZSlDSM1uMtAHaHn&w=143&h=150&c=8&rs=1&qlt=90&r=0&o=6&pid=3.1&rm=2", "rank": 7, "global_rank": 11 } ], "pagination": { "current_page": 1, "next_page": 2, "next_page_link": "https://www.bing.com/search?q=shoes&sp=-1&ghc=1&lq=0&pq=shoes&sc=10-5&qs=n&sk=&cvid=7E7228FADE1EB660479DD98270245DE8&ghsh=0&ghacc=0&ghpl=&FPIG=50B0400112484682A9D4283937787E53&first=4&FORM=PORE", "next_page_start": 4, "pages": [ { "page": 2, "link": "https://www.bing.com/search?q=shoes&sp=-1&ghc=1&lq=0&pq=shoes&sc=10-5&qs=n&sk=&cvid=7E7228FADE1EB660479DD98270245DE8&ghsh=0&ghacc=0&ghpl=&FPIG=50B0400112484682A9D4283937787E53&first=4&FORM=PERE", "start": 4 }, { "page": 3, "link": "https://www.bing.com/search?q=shoes&sp=-1&ghc=1&lq=0&pq=shoes&sc=10-5&qs=n&sk=&cvid=7E7228FADE1EB660479DD98270245DE8&ghsh=0&ghacc=0&ghpl=&FPIG=50B0400112484682A9D4283937787E53&first=14&FORM=PERE1", "start": 14 }, { "page": 4, "link": "https://www.bing.com/search?q=shoes&sp=-1&ghc=1&lq=0&pq=shoes&sc=10-5&qs=n&sk=&cvid=7E7228FADE1EB660479DD98270245DE8&ghsh=0&ghacc=0&ghpl=&FPIG=50B0400112484682A9D4283937787E53&first=24&FORM=PERE2", "start": 24 } ] } } ```
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.webscrapingapi.com/bing-search-api/basic-api-requests.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.