--- title: "Search" description: "Get one Bing results page, with every block in page order." --- > Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt) ```http GET | POST /v1/bing/search ``` Send parameters as a query string with `GET`, or as a JSON body with `POST`. Both are equivalent. ## Request ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/bing/search?q=best+running+shoes&country=US" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ q: "best running shoes", country: "US" }); const res = await fetch(`https://gateway.apinoa.com/v1/bing/search?${params}`, { headers: { "x-api-key": process.env.APINOA_API_KEY }, }); const { success, data, error } = await res.json(); ``` ```python tab="Python" import os import requests res = requests.get( "https://gateway.apinoa.com/v1/bing/search", params={"q": "best running shoes", "country": "US"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## Parameters | Parameter | Type | Required | Notes | |---|---|---|---| | `country` | enum | | The market, as an ISO 3166 country code. `US` `GB` `CA` `AU` `DE` `FR` `IT` `AT` `JP` `KR` | | `cursor` | string | | The previous page's `cursor`. Pass it alone for the next page. | | `device` | enum | | Which page to read: the desktop (default) or the mobile one. `desktop` `mobile` | | `image` | string | | An image URL: a reverse-image search instead of `q` (`type=image`). | | `lang` | string | | Interface language. | | `limit` | integer 1–50 | | Results wanted (default 10, at most 50). More than one page is charged per page. | | `q` | string | | The query, search operators included. | | `safe` | enum | | Safe search. `on` `off` | | `timeRange` | enum | | Only results from this past period. `hour` `day` `week` `month` `year` | | `type` | enum | | What to search: web results (default), news, images, videos or `image` for a reverse-image search. `web` `news` `images` `videos` `image` | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## Response Returns [`ResultsPage`](/docs/api-reference/serp/response-schema#resultspage) in `data`. A real response, shortened: arrays keep their first entries and long text is cut. ```json { "success": true, "data": { "engine": "bing", "query": "best running shoes", "type": "web", "outcome": "results", "country": "US", "lang": "en", "device": "desktop", "totalResults": 24200, "page": 1, "items": [ { "type": "organic", "rank": 1, "position": 1, "url": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/", "title": "The 15 Best Running Shoes of 2026, Tested by Runner’s World", "snippet": "Find the best running shoes of 2026, including Runner’s World–tested picks from Adidas, Brooks, New Balance, Nike, …", "site": "runnersworld.com", "displayUrl": "https://www.runnersworld.com › ... › best-running-shoes", "date": "2026-10-22" }, { "type": "organic", "rank": 2, "position": 2, "url": "https://www.outdoorgearlab.com/topics/shoes-and-boots/best-running-shoes", "title": "10 Best Running Shoes of 2026 | Tested & Ranked - GearLab", "snippet": "We run more than 50 miles in every pair of shoes we test, putting top models head to head to find the best from Nike, …", "site": "outdoorgearlab.com", "displayUrl": "https://www.outdoorgearlab.com › ... › best-running-shoes", "date": "2026-05-14" }, { "type": "organic", "rank": 3, "position": 3, "url": "https://runtothefinish.com/best-running-shoes/", "title": "Best Running Shoes Of 2026 - RunToTheFinish", "snippet": "The best running shoes right now after thousands of miles of testing from our team. We've got options for every need.", "site": "runtothefinish.com", "displayUrl": "https://runtothefinish.com › best-running-shoes", "date": "2026-08-21" }, { "type": "other", "rank": 8, "kind": "b_msg", "text": "Some results have been removed", "links": [{"url": "http://go.microsoft.com/fwlink/?LinkID=617350", "title": "Some results have been removed"}] }, { "type": "ad", "rank": 12, "block": "bottom", "url": "https://www.fitflop.com/us/en/shop/womens-sneakers-us?&@family=vitamin-ff&gclid=8d013d3d631a1163001657de889041cc&gclsrc=3p.ds&msclkid=8d013d3d631a1163001657de88…", "title": "Shop FitFlop ™ Sneakers | Shop Sneakers, Sandals & More", "snippet": "Discover the Difference Now. Shop Sneakers at the Official Store. Smart Engineering For Effortless Movement And Seamless Support", "advertiser": "FitFlop", "displayUrl": "https://www.fitflop.com › us › sneakers", "sitelinks": [ { "url": "https://www.fitflop.com/us/en/shop/water-resistant-shoes-us?gclid=3b0ba5d7da621ee2b7a5cf3431e87cbe&gclsrc=3p.ds&msclkid=3b0ba5d7da621ee2b7a5cf3431e87cbe&utm_sou…", "title": "Water Resistant Shoes" }, { "url": "https://www.fitflop.com/us/en/shop/womens-slippers-us?gclid=63759f35d8631399ca24f5d633e9b66d&gclsrc=3p.ds&msclkid=63759f35d8631399ca24f5d633e9b66d&utm_source=bi…", "title": "New Women's Slippers" } ], "ext": { "cta": "Shop Now", "adLibrary": { "advertiser": "FitFlop Ltd", "country": "GB", "payer": "FitFlop LTD", "url": "https://adlibrary.ads.microsoft.com/advertiser/165000085" } }, "favicon": "https://th.bing.com/th/id/ODF.hiRn35QxflKhhSBUsJl52w?w=32&h=32&o=6&pid=AdsPlus", "rating": 4.5, "reviewCount": 65, "extensions": [ {"text": "Styles: Sandals, Flip Flops, Trainers, Shoes, Ballerinas, Boots, High Top, Low Top"}, { "text": "\"These are the best welly boots ever!\" - from consumer review", "url": "https://www.trustpilot.com/review/fitflop.com" } ] }, { "type": "relatedSearches", "rank": 15, "queries": ["best running shoes for men", "best running shoes for women"] } ], "cursor": "kdchOqXs1C4Wf-slNuukPsr7eFzQ9oHz-d-cICT9lOAT31qO2NyNUibsLaeesVkC-QC2E0NokLgOTO7inqDdOpMlUeSZ2kUzIwNp0en7k7hAC9gRJQMJo67_k-XqvN5TaK8L8k7xjzvO1eH3JL2EVaUjUHz6Nmv0…", "fetchedAt": "2026-10-30T00:57:44.939Z" } } ``` ## Errors | Status | Code | Meaning | |---|---|---| | 400 | `INVALID_CURSOR` | The `cursor` is not one this operation returned. Start again without it. | | 400 | `INVALID_PARAMS` | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. | | 401 | `UNAUTHORIZED` | The `x-api-key` header is missing, or the key is revoked or unknown. | | 402 | `INSUFFICIENT_BALANCE` | The balance does not cover this call. Top up in the dashboard. | | 429 | `MARKETPLACE_SATURATED` | Too many concurrent calls. Retry after the `Retry-After` seconds. | | 502 | `UPSTREAM_ERROR` | The engine answered with something unusable. Retry with backoff. | | 503 | `SERVICE_UNAVAILABLE` | A temporary failure. Retry with backoff. | Every code is listed in [Errors](/docs/errors). Failed calls are not billed. ## Pricing **Price** $0.0012 per call, plus $0.0012 for each extra call it makes — at most 4 more, so $0.006 in total. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## Notes - `type=image` with an `image` URL instead of `q` runs a reverse-image search. - `limit` above one page reads further pages, one unit each.