# 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](https://docs.webscrapingapi.com/bing-search-api/getting-started/api-parameters) to your request: * `api_key` - Your [personal API key](https://docs.webscrapingapi.com/getting-started/access-the-api#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 } ] } } ```