--- title: "Bing Search" method: GET path: "/search" --- # Bing Search `GET /search` ## Request - Base URL: `https://www.searchapi.io/api/v1` - URL: `https://www.searchapi.io/api/v1/search` - Auth: one of: - API key in header `Authorization` - API key in query parameter `api_key` ## Query parameters - `engine` 'bing', required - `q` string, required - `device` 'mobile' | 'desktop' - `location` string - `lat` number - `lon` number - `market_code` 'es-ar' | 'en-au' | 'de-at' | 'nl-be' | 'fr-be' | 'pt-br' | 'en-ca' | 'fr-ca' | 'es-cl' | 'da-dk' | 'fi-fi' | 'fr-fr' | 'de-de' | 'zh-hk' | 'en-in' | 'en-id' | 'it-it' | 'ja-jp' | 'ko-kr' | 'en-my' | 'es-mx' | 'nl-nl' | 'en-nz' | 'no-no' | 'zh-cn' | 'pl-pl' | 'en-ph' | 'ru-ru' | 'en-za' | 'es-es' | 'sv-se' | 'fr-ch' | 'de-ch' | 'zh-tw' | 'tr-tr' | 'en-gb' | 'en-us' | 'es-us' - `country_code` 'AR' | 'AU' | 'AT' | 'BE' | 'BR' | 'CA' | 'CL' | 'DK' | 'FI' | 'FR' | 'DE' | 'HK' | 'IN' | 'ID' | 'IT' | 'JP' | 'KR' | 'MY' | 'MX' | 'NL' | 'NZ' | 'NO' | 'PL' | 'PT' | 'PH' | 'RU' | 'SA' | 'ZA' | 'ES' | 'SE' | 'CH' | 'TW' | 'TR' | 'GB' | 'US' | 'CN' - `language` 'ar' | 'eu' | 'bn' | 'bg' | 'ca' | 'zh-hans' | 'zh-hant' | 'hr' | 'cs' | 'da' | 'nl' | 'en' | 'en-gb' | 'et' | 'fi' | 'fr' | 'gl' | 'de' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'it' | 'jp' | 'kn' | 'ko' | 'lv' | 'lt' | 'ms' | 'ml' | 'mr' | 'nb' | 'pl' | 'pt-br' | 'pt-pt' | 'pa' | 'ro' | 'ru' | 'sr' | 'sk' | 'sl' | 'es' | 'sv' | 'ta' | 'te' | 'th' | 'tr' | 'uk' | 'vi' - `safe_search` 'off' | 'moderate' | 'strict' - `time_period` 'last_day' | 'last_week' | 'last_month' | 'last_year' - `time_period_min` string - `time_period_max` string - `filters` string - `page` integer - `next_page_token` string - `num` integer ## Response `200` Successful response - SearchResponse - `search_metadata` SearchMetadata - `id` string, required: Unique identifier for the search request - `status` string, required: Status of the search request - `created_at` string, date-time, required: Timestamp when the search was created - `request_time_taken` number: Time taken to make the request in seconds - `parsing_time_taken` number: Time taken to parse the results in seconds - `total_time_taken` number: Total time taken for the search in seconds - `request_url` string: Bing URL for this search - `html_url` string: URL to view HTML results - `json_url` string: URL to view JSON results - `search_parameters` SearchParameters - `engine` string: Search engine used - `q` string: Search query - `device` string: Device type used for search - `location` string: Location parameter provided - `location_used` string: Canonical location name actually used - `lat` number: Latitude provided - `lon` number: Longitude provided - `market_code` string: Market code used - `country_code` string: Country code used - `language` string: Language code used - `safe_search` string: Safe search filter used - `filters` string: Additional filters used - `time_period` string: Time period filter - `time_period_min` string: Start date for time period - `time_period_max` string: End date for time period - `page` integer: Page number requested - `next_page_token` string: Token for pagination - `num` integer: Number of results requested - `search_information` SearchInformation - `query_displayed` string: Query as displayed by Bing - `total_results` integer: Total number of results found - `page` integer: Current page number - `detected_location` string: Location detected by Bing - `detected_latitude` string: Detected latitude - `detected_longtitude` string: Detected longitude - `ai_overview` AiOverview - `text_blocks` TextBlock[] - `type` 'paragraph' | 'header' | 'heading' | 'ordered_list' | 'unordered_list' | 'image' | 'table' | 'code_blocks': Type of text block - `answer` string: Text content for paragraph, header, or heading blocks, or a plaintext rendering of a table - `reference_indexes` integer[]: Reference indexes linking to reference_links array - `items` ListItem[]: List items for ordered_list and unordered_list types - `type` 'paragraph': Type of list item (always paragraph) - `answer` string: Text content of the list item - `reference_indexes` integer[]: Reference indexes for the list item - `title` string: Title or alt text for image blocks - `image` string: Image URL for image type blocks - `table` object: Structured table data (for table type) - `headers` string[]: Header cell text, one entry per column - `rows` array[]: Body rows, each an array of cell text - string[] - `code` string: Source code contents (for code_blocks type) - `language` string: Detected programming language (for code_blocks type) - `markdown` string: Markdown formatted version of the AI overview - `reference_links` ReferenceLink[] - `index` integer: Zero-based reference index - `title` string: Title of reference - `link` string: URL of reference - `displayed_link` string: Displayed URL - `snippet` string: Snippet text - `source` string: Source name - `organic_result` CopilotOrganicResult - `title` string, required: Article title - `link` string: Decoded destination URL - `snippet` string: Article excerpt - `source` string: Display source name - `source_icon` string: Source favicon URL - `displayed_link` string: Breadcrumb-style URL shown next to the source - `thumbnail` string: Hero image URL - `inline_video` CopilotInlineVideo - `title` string, required: Video title - `link` string: Video URL (decoded from Bing tracking) - `thumbnail` string: Video thumbnail URL - `duration` string: Video duration in mm:ss or h:mm:ss - `date` string: Upload date - `source` string: Video platform (e.g. YouTube, Vimeo) - `channel` string: Publishing channel - `views` string: View count as displayed (e.g. "882.2K views") - `extracted_views` integer: Numeric view count - `web_results` CopilotWebResult[]: Supporting web snippets and related sites (Copilot answers) - `position` integer: 1-based position of the web result within the list - `title` string, required: Result title - `link` string: Decoded destination URL - `snippet` string: Result snippet - `source` string: Display source name - `source_icon` string: Source favicon URL - `thumbnail` string: Thumbnail URL when the card is a related-site magazine block - `related_questions` CopilotRelatedQuestion[]: People-also-ask cards rendered inside the Copilot answer - `question` string, required: People-also-ask question - `answer` string: Answer snippet - `link` string: Decoded source URL backing the answer - `source` string: Source domain - `related_queries` CopilotRelatedQuery[]: Suggested follow-up queries shown in the Copilot carousel - `query` string, required: Suggested follow-up query - `link` string: Decoded `copilotsearch` URL for the suggested query - `error` string: Error message when AI overview fails to load - `shopping_ads` ShoppingAd[] - `position` integer, required: Position in results - `block_position` string: Block position identifier - `title` string, required: Product title - `seller` string: Seller name - `link` string, required: Product link - `price` string, required: Formatted price - `extracted_price` number: Extracted price value - `original_price` string: Original price before discount - `extracted_original_price` number: Extracted original price value - `rating` number: Product rating - `reviews` integer: Number of reviews - `reviews_link` string: Link to reviews - `image` string, required: Product image URL - `deal` string: Deal information - `delivery_price` string: Delivery price - `extracted_delivery_price` number: Extracted delivery price value - `delivery_return` string: Delivery and return info - `order_fulfillment_method` string: Order fulfillment method - `extensions` string[]: Additional product features - `views` integer: Number of views - `promo` ShoppingAdPromo - `text` string: Promotion text - `footnote` string: Promotion footnote - `link` string: Promotion link - `code` string: Promotion code - `installment` ShoppingAdInstallment - `down_payment` string: Down payment amount - `extracted_down_payment` number: Extracted down payment value - `months` string: Number of months - `extracted_months` integer: Extracted months value - `cost_per_month` string: Cost per month - `extracted_cost_per_month` number: Extracted cost per month value - `ads` Ad[] - `position` integer: Position in results - `block_position` string: Block position identifier - `title` string, required: Ad title - `link` string, required: Ad destination URL - `source` string: Ad source - `displayed_link` string, required: Display URL - `tracking_link` string: Click tracking URL - `snippet` string, required: Ad description - `is_app` boolean: Whether this is an app ad - `sitelinks` AdSitelinks - `inline` AdSitelink[] - `title` string: Sitelink title - `link` string: Sitelink URL - `snippet` string: Sitelink description - `position` integer: Position in sitelinks - `expanded` AdSitelink[] - `title` string: Sitelink title - `link` string: Sitelink URL - `snippet` string: Sitelink description - `position` integer: Position in sitelinks - `list` AdSitelink[] - `title` string: Sitelink title - `link` string: Sitelink URL - `snippet` string: Sitelink description - `position` integer: Position in sitelinks - `assets` AdAssets - `rating` number: Rating value - `reviews` number: Number of reviews - `structured_snippet` AdStructuredSnippet - `title` string: Snippet title - `text` string: Snippet text - `action` AdAction - `text` string: Action text - `link` string: Action link - `prices` AdPrice[] - `title` string: Price title - `price` string: Price text - `extracted_price` number: Extracted price value - `description` string: Price description - `link` string: Price link - `promotion` AdPromotion - `title` string: Promotion title - `link` string: Promotion link - `application` AdApplication - `title` string: Application title - `link` string: Application link - `text` string: Application text - `call_to_action` AdCallToAction - `text` string: Call to action text - `link` string: Call to action link - `extensions` string[]: Additional ad extensions - `more_link` string: Link to more results - `images` string[]: Ad images - `thumbnail` string: Ad thumbnail image - `answer_box` AnswerBox: Answer box can have dynamic attributes from the organic result type - `type` 'organic_result' | 'core_answer': Type of answer box - `title` string: Answer title (organic_result type only) - `answer` string: Answer text - `thumbnail` string: Thumbnail URL (core_answer type only) - `related_answers` string[]: Related answers (core_answer type only) - `organic_result` OrganicResult - `position` integer, required: Position in search results - `title` string, required: Result title - `link` string, required: Result URL - `source` string, required: Source name - `domain` string, required: Domain name - `displayed_link` string, required: Displayed URL - `snippet` string, required: Result snippet - `snippet_highlighted_words` string[] - `favicon` string: Favicon URL - `cached_page_link` string: Cached page URL - `date` string: Result date - `images` string[]: Images from result - `thumbnail` string: Result thumbnail image - `sitelinks` Sitelinks - `type` 'inline' | 'expanded' | 'list': Type of sitelinks - `sitelinks` Sitelink[] - `title` string: Sitelink title - `link` string: Sitelink URL - `snippet` string: Sitelink description - `rich_snippet` RichSnippet - `detected_extensions` object - `rating` number: Rating value - `reviews` integer: Number of reviews - `table` object[]: Table data from rich snippet - `questions` object[]: Questions and answers - `question` string: Question text - `link` string: Question URL - `answer` string: Answer text - `coupons` object[]: Available coupons - `text` string: Coupon text - `promo_code` string: Promotional code - `articles` object[]: Related articles - `title` string: Article title - `link` string: Article URL - `thumbnail` string: Article thumbnail image - `extension` string: Article extension text - `extensions` string[]: List of text extensions - `explore_further` ExploreFurther[] - `title` string: Title of exploration - `domain` string: Domain to search - `link` string: Search URL - `knowledge_graph` KnowledgeGraph - `title` string: Entity name - `website` string: Entity website - `address` string: Business address - `phone` string: Phone number - `hours` string: Operating hours text - `open_hours` OpenHour[]: Structured opening hours - `name` string: Day name - `value` string: Hours for that day - `organic_results` OrganicResult[] - `position` integer, required: Position in search results - `title` string, required: Result title - `link` string, required: Result URL - `source` string, required: Source name - `domain` string, required: Domain name - `displayed_link` string, required: Displayed URL - `snippet` string, required: Result snippet - `snippet_highlighted_words` string[] - `favicon` string: Favicon URL - `cached_page_link` string: Cached page URL - `date` string: Result date - `images` string[]: Images from result - `thumbnail` string: Result thumbnail image - `sitelinks` Sitelinks - `type` 'inline' | 'expanded' | 'list': Type of sitelinks - `sitelinks` Sitelink[] - `title` string: Sitelink title - `link` string: Sitelink URL - `snippet` string: Sitelink description - `rich_snippet` RichSnippet - `detected_extensions` object - `rating` number: Rating value - `reviews` integer: Number of reviews - `table` object[]: Table data from rich snippet - `questions` object[]: Questions and answers - `question` string: Question text - `link` string: Question URL - `answer` string: Answer text - `coupons` object[]: Available coupons - `text` string: Coupon text - `promo_code` string: Promotional code - `articles` object[]: Related articles - `title` string: Article title - `link` string: Article URL - `thumbnail` string: Article thumbnail image - `extension` string: Article extension text - `extensions` string[]: List of text extensions - `explore_further` ExploreFurther[] - `title` string: Title of exploration - `domain` string: Domain to search - `link` string: Search URL - `local_map` LocalMap - `link` string: Map link - `image` string: Map image URL - `gps_coordinates` GpsCoordinates - `latitude` number: Latitude - `longitude` number: Longitude - `local_results` LocalResult[] - `position` integer: Position in results - `id` string: Business identifier - `title` string: Business name - `link` string: Business link - `rating` number: Business rating - `reviews` integer: Number of reviews - `reviews_source` string: Source of reviews - `price` string: Price range - `price_description` string: Price range description - `type` string: Business type - `address` string: Business address - `phone` string: Phone number - `is_sponsored` boolean: Whether this is a sponsored result - `is_closed` boolean: Whether business is currently closed - `is_open` boolean: Whether business is currently open - `open_hours` string: Current hours status - `extensions` string[]: Business features - `website` string: Website URL - `direction` string: Directions URL - `gps_coordinates` GpsCoordinates - `latitude` number: Latitude - `longitude` number: Longitude - `thumbnail` string: Thumbnail URL - `is_copilot_answer` boolean: Whether this is from copilot layout - `top_stories` TopStory[] - `position` integer, required: Position in results - `title` string, required: Story title - `snippet` string: Story snippet - `link` string, required: Story URL - `source` string, required: News source - `date` string, required: Publication date - `is_live` boolean: Whether story is live - `is_video` boolean: Whether story is a video - `tag` string: Story tag/category - `thumbnail` string: Thumbnail URL - `is_copilot_answer` boolean: Whether this is from copilot layout - `related_questions` RelatedQuestion[] - `question` string, required: Question text - `answer` string, required: Answer text - `source` OrganicResult - `position` integer, required: Position in search results - `title` string, required: Result title - `link` string, required: Result URL - `source` string, required: Source name - `domain` string, required: Domain name - `displayed_link` string, required: Displayed URL - `snippet` string, required: Result snippet - `snippet_highlighted_words` string[] - `favicon` string: Favicon URL - `cached_page_link` string: Cached page URL - `date` string: Result date - `images` string[]: Images from result - `thumbnail` string: Result thumbnail image - `sitelinks` Sitelinks - `type` 'inline' | 'expanded' | 'list': Type of sitelinks - `sitelinks` Sitelink[] - `title` string: Sitelink title - `link` string: Sitelink URL - `snippet` string: Sitelink description - `rich_snippet` RichSnippet - `detected_extensions` object - `rating` number: Rating value - `reviews` integer: Number of reviews - `table` object[]: Table data from rich snippet - `questions` object[]: Questions and answers - `question` string: Question text - `link` string: Question URL - `answer` string: Answer text - `coupons` object[]: Available coupons - `text` string: Coupon text - `promo_code` string: Promotional code - `articles` object[]: Related articles - `title` string: Article title - `link` string: Article URL - `thumbnail` string: Article thumbnail image - `extension` string: Article extension text - `extensions` string[]: List of text extensions - `explore_further` ExploreFurther[] - `title` string: Title of exploration - `domain` string: Domain to search - `link` string: Search URL - `related_searches` RelatedSearch[] - `query` string, required: Related search query - `link` string, required: Search link - `inline_videos` InlineVideo[] - `position` integer, required: Position in results - `title` string, required: Video title - `link` string, required: Video URL - `source` string: Video source - `channel` string: Channel name - `duration` string: Video duration - `views` integer: View count - `date` string: Upload date - `thumbnail` string, required: Thumbnail URL - `description` string: Video description - `video_link` string: Direct video link - `is_adult` string: Adult content flag - `inline_shorts` InlineShort[] - `position` integer: Position in results - `title` string: Short video title - `link` string: Short video URL - `source` string: Video source - `channel` string: Channel name - `views` integer: View count - `duration` string: Duration - `thumbnail` string: Thumbnail URL - `inline_images` InlineImages - `images` InlineImage[] - `title` string: Image title - `link` string: Image link - `source` object: Image source information - `name` string: Source name - `thumbnail` string: Thumbnail URL - `suggestions` ImageSuggestion[] - `title` string: Suggestion text - `link` string: Suggestion link - `thumbnail` string: Suggestion thumbnail URL - `inline_shopping` InlineShoppingItem[] - `position` integer, required: Position in results - `title` string, required: Product title - `link` string, required: Product URL - `seller` string: Seller name - `price` string, required: Product price - `extracted_price` number: Extracted price value - `original_price` string: Original price - `extracted_original_price` number: Extracted original price - `rating` number: Product rating - `reviews` integer: Number of reviews - `thumbnail` string, required: Product image URL - `rebate` string: Rebate information - `delivery` string: Delivery information - `pagination` Pagination - `current` integer, required: Current page number - `next` string: URL for next page - `next_page_token` string: Token to retrieve the next page of results - `previous` string: URL for previous page - `other_pages` object: URLs for specific page numbers - `error` string: Error message when no results are returned ## Other responses - `400`: Validation Error. There is an issue with query parameters, such as missing required parameters or invalid values. - `401`: Authentication Error. The API key is missing or invalid. - `429`: Rate Limit Exceeded. The number of allowed requests has been exceeded. Consider upgrading your plan or waiting for the limit to reset. - `500`: Server Error. Internal server error. - `503`: Timeout. We could not retrieve results in 90 seconds. --- [API](https://skmtc.dev/searchapi/apis/bing-api.md) - [All operations](https://skmtc.dev/searchapi/apis/bing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/searchapi/apis/bing-api/revisions/71d449152d7e?raw)