{"openapi":"3.1.0","info":{"title":"API.SH: Bing","version":"1.0.0","description":"The Bing API from API.SH: public Bing data as clean JSON. Every endpoint is a GET with query parameters and your key in the x-api-key header. Calls that run cost the credits shown (x-credits): successes, and lookups that found nothing (404). Refused calls and errors on our side are free. Docs: https://api.sh/docs · Every platform: https://api.sh/openapi.json","contact":{"name":"API.SH support","email":"support@api.sh","url":"https://api.sh/contact"},"termsOfService":"https://api.sh/legal/terms"},"servers":[{"url":"https://api.api.sh"}],"security":[{"apiKey":[]}],"tags":[{"name":"Account","description":"Your balance, usage, logs and past responses. Free."},{"name":"Bing","description":"7 endpoints (search & seo)","x-slug":"bing","x-domains":["bing.com"]}],"paths":{"/v1/account":{"get":{"operationId":"getAccount","tags":["Account"],"summary":"Balance, plan, spend and spend limits","description":"Credits by bucket (free monthly, plan, pay-as-you-go), the plan, credits spent today and this month (UTC), your spend limits and the key used. Free: costs no credits.","responses":{"200":{"description":"Account","content":{"application/json":{"example":{"success":true,"account":{"id":"8f0c…","status":"active","unlimited":false},"credits":{"total":41250,"free":100,"plan":0,"payg":41150,"free_resets_at":"2026-11-01T00:00:00Z"},"plan":null,"spend":{"today":120,"this_month":3400,"daily_limit":5000,"monthly_limit":null,"period":"UTC"},"key":{"id":"…","name":"production","prefix":"ash_li","created_at":"2026-10-01T00:00:00Z"}}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/usage":{"get":{"operationId":"getAccountUsage","tags":["Account"],"summary":"Usage per day and per endpoint","description":"Calls, errors and credits per UTC day, and the top endpoints by credits. Free. Add output=csv for the daily rows as CSV.","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"default":30}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/logs":{"get":{"operationId":"listAccountLogs","tags":["Account"],"summary":"Your calls of the last 30 days","description":"Newest first. Filter by status, route prefix, key or time; page with `before` (the `next` value). Add output=csv|ndjson to download (up to 5,000 rows per request; the next cursor is in the x-next-cursor header). Free.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"status","in":"query","required":false,"description":"ok, error, or an HTTP status like 502.","schema":{"type":"string"}},{"name":"route","in":"query","required":false,"description":"Route prefix, e.g. /tiktok/v1","schema":{"type":"string"}},{"name":"key","in":"query","required":false,"description":"Only calls made with this key id.","schema":{"type":"string","format":"uuid"}},{"name":"since","in":"query","required":false,"description":"ISO time.","schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","required":false,"description":"Cursor from `next`.","schema":{"type":"string"}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Calls","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/results/{request_id}":{"get":{"operationId":"getResult","tags":["Account"],"summary":"Fetch a past response again, free","description":"The exact response a call returned, for 30 days after the call, at no cost. Use the call's x-request-id. Supports output=csv|ndjson.","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The stored response (headers: x-refetch: 1, x-original-time, x-original-route).","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Older than 30 days.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bing/v1/images":{"get":{"operationId":"bingImages","summary":"Bing Images","description":"Bing image results, 35 per page: full-size image URL, thumbnail, source page and domain, title, description and dimensions. Pass `next_page` back as `page`. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/bing-images","tags":["Bing"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"coffee machine"},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"size","in":"query","required":false,"description":"small, medium, large, wallpaper.","schema":{"type":"string","enum":["small","medium","large","wallpaper"]}},{"name":"color","in":"query","required":false,"description":"color, bw, or red, orange, yellow, green, teal, blue, purple, pink, brown, black, gray, white.","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"photo, clipart, line, gif, transparent.","schema":{"type":"string","enum":["photo","clipart","line","gif","transparent"]}},{"name":"layout","in":"query","required":false,"description":"square, wide, tall.","schema":{"type":"string","enum":["square","wide","tall"]}},{"name":"people","in":"query","required":false,"description":"face, portrait.","schema":{"type":"string","enum":["face","portrait"]}},{"name":"time","in":"query","required":false,"description":"day, week, month, year.","schema":{"type":"string","enum":["day","week","month","year"]}},{"name":"license","in":"query","required":false,"description":"any, public, share, share_commercially, modify, modify_commercially.","schema":{"type":"string"}},{"name":"market","in":"query","required":false,"description":"e.g. en-US, de-DE (or country + language).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"e.g. US.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"e.g. en.","schema":{"type":"string"}},{"name":"safe","in":"query","required":false,"description":"strict, moderate, off.","schema":{"type":"string","enum":["strict","moderate","off"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"Eiffel Tower","page":1,"market":"en-US","filters":{},"count":35,"next_page":2,"images":[{"position":1,"title":"Where In Paris Is The Eiffel Tower Located at Lewis Burcham blog","description":"Where In Paris Is The Eiffel Tower Located at Lewis Burcham blog","image_url":"https://cdn.britannica.com/52/245552-050-3D7334F9/Eiffel-Tower-Paris.jpg","thumbnail":"https://ts3.mm.bing.net/th?id=OIP.54RmpGCUWV9JgeBRQFxVjAHaHo&pid=15.1","page_url":"https://storage.googleapis.com/dsyfzqqrilomee/where-in-paris-is-the-eiffel-tower-located.html","source_domain":"storage.googleapis.com","width":1551,"height":1600,"bing_cdn_url":"https://th.bing.com/th/id/R.e78466a46094595f4981e051405c558c?rik=ZFj6C%2fXUZxKzHg&pid=ImgRaw&r=0","id":"E58B53AD99F337AE9EC21EB31267D4F50BFA5864","md5":"e78466a46094595f4981e051405c558c"},{"position":2,"title":"Exploring the Eiffel Tower, the Tallest Building in Paris - Traveldigg.com","description":"Exploring the Eiffel Tower, the Tallest Building in Paris - Traveldigg.com","image_url":"https://traveldigg.com/wp-content/uploads/2016/06/Eiffel-Tower-Paris-France.jpg","thumbnail":"https://ts3.mm.bing.net/th?id=OIP.y3EfJXP3R4uvuTkG3S9vkAHaE_&pid=15.1","page_url":"https://traveldigg.com/eiffel-tower/","source_domain":"traveldigg.com","width":1600,"height":1079,"bing_cdn_url":"https://th.bing.com/th/id/R.cb711f2573f7478bafb93906dd2f6f90?rik=En5S6M%2foBzWhRg&pid=ImgRaw&r=0","id":"B1AF13E05351E3BF7B9346A13507E8CFE8527E12","md5":"cb711f2573f7478bafb93906dd2f6f90"},"… 33 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/bing/v1/keywords":{"get":{"operationId":"bingKeywords","summary":"Bing keyword suggestions","description":"Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/bing-keywords","tags":["Bing"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"web scraping tools"},{"name":"market","in":"query","required":false,"description":"Bing market, e.g. en-US, en-GB, de-DE.","schema":{"type":"string"},"example":"en-US"},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"web scraping tools","market":"en-US","keywords":["web scraping tools free","web scraping tools list","… 9 more"],"credits_used":1,"cached":false}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/bing/v1/maps":{"get":{"operationId":"bingMaps","summary":"Bing Maps","description":"Local places from Bing Maps: name, address, phone, website, rating and review count with their source, category, open state and hours, image and coordinates; up to 18 per page. Put the place in `location` or in the query itself. Pass `next_page` back as `page`. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/bing-maps","tags":["Bing"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"description":"Search query.","schema":{"type":"string"},"example":"coffee"},{"name":"location","in":"query","required":false,"description":"City, address or area, e.g. Seattle, WA.","schema":{"type":"string"},"example":"Seattle, WA"},{"name":"page","in":"query","required":false,"description":"Page number (1 = first).","schema":{"type":"integer"}},{"name":"market","in":"query","required":false,"description":"Bing market, e.g. en-US (default), ja-JP.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"search_parameters":{"engine":"bing_maps","q":"coffee","location":null,"page":1,"market":"en-US"},"query":"coffee","page":1,"count":7,"places":[{"position":1,"title":"Ocean Boulevard Coffee","id":"ypid:YNF166E2C9DD56E018","category":"Cafe","address":"132 Ocean Blvd W, Holden Beach, NC 28462","phone":"+1 555 010 0000","website":"https://www.oceanblvdcoffee.com/","rating":4.5,"reviews":55,"rating_source":"Yelp","open_state":"Closed","hours":null,"price":null,"image":"https://www.bing.com/th?id=OLC.RIl5v/mu+cqeNg480x360&pid=Local","coordinates":{"latitude":33.914039611816406,"longitude":-78.27005767822266}},{"position":2,"title":"Cafe Ahora","id":"ypid:YNE0509FC604A31C1C","category":"Cafe","address":"604 Ocean Hwy E, Bolivia, NC 28422","phone":"+1 555 010 0000","website":"https://www.cafeahora.com/","rating":null,"reviews":null,"rating_source":null,"open_state":"Closed","hours":"Closed now, opens at 6 AM","price":null,"image":"https://www.bing.com/th?id=OLC.kNw3X0KCYArWdQ480x360&pid=Local","coordinates":{"latitude":34.03300857543945,"longitude":-78.25541687011719}},"… 5 more"],"next_page":null,"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/bing/v1/news":{"get":{"operationId":"bingNews","summary":"Bing News","description":"Bing News articles: title, URL, source, snippet, age and image; 10 on page 1, then 20 per page. Pass `next_page` back as `page`. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/bing-news","tags":["Bing"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"apple"},{"name":"page","in":"query","required":false,"schema":{"type":"integer"}},{"name":"time","in":"query","required":false,"description":"hour, day, week, month.","schema":{"type":"string","enum":["hour","day","week","month"]}},{"name":"sort","in":"query","required":false,"description":"relevance (default) or date.","schema":{"type":"string","enum":["relevance","date"]}},{"name":"market","in":"query","required":false,"description":"e.g. en-US, de-DE (or country + language).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"e.g. US.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"e.g. en.","schema":{"type":"string"}},{"name":"safe","in":"query","required":false,"description":"strict, moderate, off.","schema":{"type":"string","enum":["strict","moderate","off"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"apple","page":1,"market":"en-US","filters":{"time":null,"sort":null},"count":12,"next_page":2,"articles":[{"position":1,"title":"Apple warns of risks related to AI agents behaving in 'unintended or unpredictable' ways","url":"https://www.cnbc.com/2026/11/03/apple-warns-of-ai-agents-behave-in-unintended-or-unpredictable-ways.html","source":"CNBC","snippet":"Apple’s annual filing warns that AI agents could exceed permissions, resist instructions or take actions that are difficult ...","age":"9 hours ago","image":"https://th.bing.com/th?id=ONUT.CykDHa1MGVW4s55Hzzmd1A&pid=News&w=234&h=132&c=14&rs=2&qlt=90","id":"6aeac9d95e5d426dbad11bc341d62397"},{"position":2,"title":"Want an iPhone Duo for the holidays? Apple’s latest stock update isn’t reassuring","url":"https://www.zdnet.com/tech/apple-foldable-iphone-duo-stock-shortage/","source":"ZDNET","snippet":"Those who didn’t initially jump to preorder the new device or wait in line at an Apple store are still facing shipping times ...","age":"10 hours ago","image":"https://th.bing.com/th?id=ONUT.UROZjTq7Rxb3FnxwkXivrQ&pid=News&w=234&h=132&c=14&rs=2&qlt=90","id":"6aeac9d95e5d426dbad11bc341d62397"},"… 10 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/bing/v1/search":{"get":{"operationId":"bingSearch","summary":"Bing web search","description":"Bing web results (one page of up to 10) with related searches and answers. Bing serves page 2 as a repeat of page 1, so `next_page` is null. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/bing-search","tags":["Bing"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"coffee"},{"name":"time","in":"query","required":false,"description":"day, week, month.","schema":{"type":"string","enum":["day","week","month"]}},{"name":"market","in":"query","required":false,"description":"e.g. en-US, de-DE (or country + language).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"e.g. US.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"e.g. en.","schema":{"type":"string"}},{"name":"safe","in":"query","required":false,"description":"strict, moderate, off.","schema":{"type":"string","enum":["strict","moderate","off"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"Eiffel Tower","page":1,"market":"en-US","next_page":null,"next_cursor":null,"results":[{"title":"The OFFICIAL Eiffel Tower website: tickets, news, info...","url":"https://www.toureiffel.paris/en","description":"To round out your visit, discover the cultural sites located near the Eiffel Tower. We’ve selected a variety of museums and historical …","position":1,"site_name":"toureiffel.paris","display_url":"https://www.toureiffel.paris › en","favicon":"https://th.bing.com/th/id/ODLS.A2450BEC-5595-40BA-9F13-D9EC6AB74B9F?w=32&h=32&qlt=90&pcl=fffffa&o=6&pid=1.2","date":null,"deep_links":[],"facts":[],"thumbnail":null,"bing_link":"https://www.bing.com/ck/a?!&&p=0612ea2ed22d783c3872f014dd21b3f3e8e818069abf42942db3c4b76aae78bbJmltdHM9MTc5MzY2NDAwMA&ptn=3&ver=2&hsh=4&fcli…","text":"toureiffel.parishttps://www.toureiffel.paris › enThe OFFICIAL Eiffel Tower website: tickets, news, info...To round out your visit, discover …"},{"title":"Eiffel Tower - Wikipedia","url":"https://en.wikipedia.org/wiki/Eiffel_Tower","description":"The Eiffel Tower (/ ˈaɪfəl / ⓘ EYE-fəl; French: Tour Eiffel [tuʁ ɛfɛl] ⓘ) is a lattice tower on the Champ de Mars in Paris, France. It is …","position":2,"site_name":"wikipedia.org","display_url":"https://en.wikipedia.org › wiki › Eiffel_Tower","favicon":"https://th.bing.com/th/id/ODLS.A2450BEC-5595-40BA-9F13-D9EC6AB74B9F?w=32&h=32&qlt=91&pcl=fffffa&o=6&pid=1.2","date":null,"deep_links":[],"facts":[],"thumbnail":null,"bing_link":"https://www.bing.com/ck/a?!&&p=310a0fcad4bc4fbb8260f89ad8258c077d1e59a7dc2eda179b18ed4a0d04e063JmltdHM9MTc5MzY2NDAwMA&ptn=3&ver=2&hsh=4&fcli…","text":"wikipedia.orghttps://en.wikipedia.org › wiki › Eiffel_TowerEiffel Tower - WikipediaThe Eiffel Tower (/ ˈaɪfəl / ⓘ EYE-fəl; French: Tour Eiff…"},"… 8 more"],"total":"About 50,600 results","total_results":50600,"related_searches":[],"people_also_ask":[],"answers":[],"ads":[],"pagination":[{"text":"2","href":"/search?q=Eiffel+Tower&setlang=en-US&cc=US&mkt=en-US&FPIG=397D233CE8F041329AA57A258AC585ED&first=11&FORM=PERE"},{"text":"3","href":"/search?q=Eiffel+Tower&setlang=en-US&cc=US&mkt=en-US&FPIG=397D233CE8F041329AA57A258AC585ED&first=21&FORM=PERE1"},"… 2 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/bing/v1/shopping":{"get":{"operationId":"bingShopping","summary":"Bing Shopping results","description":"Bing Shopping results for a query: product title, image, rating and review count, seller, price and original price (value and text) and the product's Bing Shopping link.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 3 credits per successful call. Docs: https://api.sh/docs/bing-shopping","tags":["Bing"],"x-credits":3,"parameters":[{"name":"q","in":"query","required":true,"description":"Search query.","schema":{"type":"string"},"example":"wireless headphones"},{"name":"mkt","in":"query","required":false,"description":"Market, e.g. en-US (default), en-GB, de-DE.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"wireless headphones","market":"en-US","count":83,"products":[{"title":"JBL Live 770NC - Wireless Over-Ear Headphones With True Adaptive Noise Cancelling With Smart Ambient, Up To 65 Hours Of Battery Life, Comfor…","image":"https://th.bing.com/th/id/OPHS.WKSmDlAiMFg6EQ474C474?w=300&h=300&o=5&pid=21.1","rating":4.5,"reviews":"5K+","seller":"Amazon.com","price":{"value":139,"text":"$139."},"original_price":{"value":199,"text":"$199."},"url":"https://www.bing.com/shop/productdetails?goid=193030804431&entryPoint=genresultspage&q=wireless+headphones&FORM=GRPPDP"},{"title":"Bowers & Wilkins Px8 Over-Ear Wireless Headphones, Black, Nappa Leather | Advanced Noise Cancelling Headphones, Dual Mics, Ios/Android Compa…","image":"https://th.bing.com/th/id/OPHS.gsy9JLX5CZDTig474C474?w=300&h=300&o=5&pid=21.1","rating":4.4,"reviews":"10K+","seller":"Amazon.com","price":{"value":519,"text":"$519."},"original_price":{"value":749,"text":"$749"},"url":"https://www.bing.com/shop/productdetails?goid=103228583777&entryPoint=genresultspage&q=wireless+headphones&FORM=GRPPDP"},"… 81 more"],"cached":false,"credits_used":3}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/bing/v1/videos":{"get":{"operationId":"bingVideos","summary":"Bing Videos","description":"Bing video results (one page of up to 35): video URL, title, duration, views, channel, publish date and thumbnail. Bings video feed returns no further pages, so `next_page` is null. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/bing-videos","tags":["Bing"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"coffee machine"},{"name":"duration","in":"query","required":false,"description":"short, medium, long.","schema":{"type":"string","enum":["short","medium","long"]}},{"name":"time","in":"query","required":false,"description":"day, week, month, year.","schema":{"type":"string","enum":["day","week","month","year"]}},{"name":"resolution","in":"query","required":false,"description":"360, 480, 720, 1080.","schema":{"type":"string","enum":["360","480","720","1080"]}},{"name":"source","in":"query","required":false,"description":"youtube, dailymotion, vimeo, facebook, tiktok.","schema":{"type":"string"}},{"name":"market","in":"query","required":false,"description":"e.g. en-US, de-DE (or country + language).","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"e.g. US.","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"e.g. en.","schema":{"type":"string"}},{"name":"safe","in":"query","required":false,"description":"strict, moderate, off.","schema":{"type":"string","enum":["strict","moderate","off"]}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"coffee machine","page":1,"market":"en-US","filters":{},"count":35,"next_page":null,"videos":[{"position":1,"title":"Best Espresso Machines (Beginner to Advanced) | Gear Heads","url":"https://www.youtube.com/watch?v=l9sCPE181r4","page_url":"https://www.youtube.com/watch?v=l9sCPE181r4","duration":"14:54","thumbnail":"https://ts1.mm.bing.net/th?id=OVP.BCnVZQbZJO2c4vUkWBmkHQEsDh&pid=15.1&W=160&H=120","views":"281.1K views","channel":"America's Test Kitchen","published":"1 year ago","id":"DE8F4D53D5FEA87CBEEDDE8F4D53D5FEA87CBEED"},{"position":2,"title":"Breville Barista Express Beginner’s Guide: Setup, How to Use & Pro Tips You NEED to Know","url":"https://www.youtube.com/watch?v=3qKgV-RE1ws","page_url":"https://www.youtube.com/watch?v=3qKgV-RE1ws","duration":"06:04","thumbnail":"https://ts4.mm.bing.net/th?id=OVP.F0Adfv-zqzHkyYcUrQSVWwEsDh&pid=15.1&W=160&H=120","views":"29.9K views","channel":"HiTechKing","published":"8 months ago","id":"51DB2BB42192525FD04551DB2BB42192525FD045"},"… 33 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Create keys at https://app.api.sh/keys. Authorization: Bearer <key> also works."}},"parameters":{"raw":{"name":"raw","in":"query","required":false,"description":"0 leaves out the bulky `raw` source blocks (often 10-30x smaller).","schema":{"type":"string","enum":["0","1"]}},"fields":{"name":"fields","in":"query","required":false,"description":"Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.","schema":{"type":"string"}},"fresh":{"name":"fresh","in":"query","required":false,"description":"1 skips the 24-hour cache and fetches live.","schema":{"type":"string","enum":["1"]}},"output":{"name":"output","in":"query","required":false,"description":"csv or ndjson returns the response's records (its main list, or the object as one row) as CSV or NDJSON instead of JSON.","schema":{"type":"string","enum":["json","csv","ndjson"]}},"records":{"name":"records","in":"query","required":false,"description":"With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.","schema":{"type":"string"}}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"string"}},"required":["success","error"]}},"responses":{"E400":{"description":"A parameter is missing or invalid. Not charged (unless the call ran and the source rejected the value; credits_used says).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E402":{"description":"Not enough credits, a spend limit you set was reached (`spend_limit`), or the key's monthly credit cap was reached (`key_cap`). Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E502":{"description":"The source site failed this time; retry. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E503":{"description":"Endpoint paused or temporarily unavailable; may include retry-after. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"headers":{"x-request-id":{"description":"The call's id (logs, re-fetch with /v1/results/{id}).","schema":{"type":"string","format":"uuid"}},"x-credits-used":{"description":"Credits charged for this call.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Balance after the call.","schema":{"type":"integer"}}}},"externalDocs":{"url":"https://api.sh/docs"}}