Quickstart: Create your first Bing Custom Search instance

To use Bing Custom Search, you need to create a custom search instance that defines your view or slice of the web. This instance contains the public domains, websites, and webpages that you want to search, along with any ranking adjustments you may want.

To create the instance, use the Bing Custom Search portal.

A picture of the Bing Custom Search portal

Prerequisites

Create an Azure resource

Start using the Bing Custom Search API by creating one of the Azure resources below.

  • Create a trial resource:

    • No Azure subscription needed.
    • Valid for seven days, for free. After signing up, a trial key and endpoint will be available on the Azure website.
  • Create a Bing Custom Search resource:

    • Available through the Azure portal until you delete the resource.
    • Use the free pricing tier to try the service, and upgrade later to a paid tier for production.
  • Create a Multi-Service resource:

    • Available through the Azure portal until you delete the resource.
    • Use the same key and endpoint for your applications, across multiple Cognitive Services.

Create a custom search instance

To create a Bing Custom Search instance:

  1. Click Get Started on the Bing Custom Search portal webpage, and sign in with your Microsoft account.

  2. Click New Instance, and enter a descriptive name. You can change the name of your instance at any time.

  3. On the Active tab under Search Experience, enter the URL of one or more websites you want to include in your search.

    Note

    Bing Custom Search instances will only return results for domains, and webpages that are public and have been indexed by Bing.

  4. You can use the right side of the Bing Custom Search portal to enter a query and examine the search results returned by your search instance. If no results are returned, try entering a different URL.

  5. Click Publish to publish your changes to the production environment, and update the instance's endpoints.

  6. Click on the Production tab under Endpoints, and copy your Custom Configuration ID. You need this ID to call the Custom Search API by appending it to the customconfig= query parameter in your calls.

Next steps