Microsoft Azure Search API

The Search API from Microsoft Azure — 18 operation(s) for search.

Documentation GitHub OpenAPI

Operations 18

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /search/autocomplete Autocomplete catalog discovery keywords · Microsoft Azure Post Search Autocomplete #

Ask an LLM

“Can I get autocomplete options while a user types catalog search keywords?”

“How do I complete a partial keyword against the data discovery catalog?”

Tell an agent

Autocomplete the catalog keyword {keywords}.

Give me {limit} autocomplete options for {keywords} using filter {filter}.

POST /search/query Search the data catalog for assets · Microsoft Azure Post Search Query #

Ask an LLM

“How do I search the data catalog for assets that match keywords?”

“Can I get facets and sort order back when querying catalog assets?”

Tell an agent

Search the data catalog for {keywords}.

Query catalog assets matching {keywords} with filter {filter} and facets {facets}.

POST /search/suggest Suggest catalog assets for a search term · Microsoft Azure Post Search Suggest #

Ask an LLM

“What asset suggestions does the catalog offer for a term I'm typing?”

“Can I show suggested catalog results instead of full search results?”

Tell an agent

Suggest catalog assets for {keywords}.

Return {limit} catalog search suggestions for {keywords} filtered by {filter}.

GET /search/polygon/{format} Get outline geometry for places · Microsoft Azure Get Search Polygon Format #

Ask an LLM

“How do I get the boundary outline of a city or country I already found in Azure Maps?”

“Can I fetch polygon geometry for geometry IDs returned by an earlier search?”

Tell an agent

Get the polygon outlines for geometry IDs {geometries} as {format}.

Fetch the boundary shape for geometry {geometries}.

GET /search/fuzzy/{format} Free-form search for addresses and places · Microsoft Azure Get Search Fuzzy Format #

Ask an LLM

“Can one search box handle both addresses and points of interest?”

“What's the way to search places with a messy free-text query near a location?”

Tell an agent

Free-form search for {query} near {lat}, {lon}.

Fuzzy search {query} limited to countries {countrySet}.

GET /search/poi/{format} Find points of interest by name · Microsoft Azure Get Search Poi Format #

Ask an LLM

“How do I find a point of interest like a specific restaurant by its name?”

“Can I search POIs by name and filter by brand?”

Tell an agent

Find points of interest named {query}.

Search POIs named {query} within {radius} meters of {lat}, {lon}.

GET /search/nearby/{format} Find points of interest around a location · Microsoft Azure Get Search Nearby Format #

Ask an LLM

“What points of interest are around a given coordinate without a search term?”

“Can I just list nearby places within a radius of my location?”

Tell an agent

Show points of interest near {lat}, {lon}.

List nearby places within {radius} meters of {lat}, {lon} in categories {categorySet}.

GET /search/poi/category/{format} Find points of interest by category · Microsoft Azure Get Search Poi Category Format #

Ask an LLM

“How do I find all gas stations or cafes by category rather than by name?”

“Can I search a POI category within a bounding area?”

Tell an agent

Find points of interest in category {query}.

Search the POI category {query} near {lat}, {lon}.

GET /search/poi/category/tree/{format} List supported POI categories · Microsoft Azure Get Search Poi Category Tree Format #

Ask an LLM

“Which point of interest categories and subcategories does Azure Maps support?”

“Where can I get category IDs to use in a categorySet filter?”

Tell an agent

Get the full POI category tree as {format}.

List the POI categories with names in {language}.

GET /search/address/{format} Geocode an address to coordinates · Microsoft Azure Get Search Address Format #

Ask an LLM

“How do I convert an address into latitude and longitude?”

“Can I geocode only addresses without getting business results?”

Tell an agent

Geocode the address {query}.

Find coordinates for {query} limited to countries {countrySet}.

GET /search/address/reverse/{format} Reverse geocode a coordinate to an address · Microsoft Azure Get Search Address Reverse Format #

Ask an LLM

“How do I turn a latitude and longitude into a street address?”

“Can reverse geocoding also return the speed limit at that point?”

Tell an agent

Reverse geocode {query} to a street address.

Get the address and speed limit at {query}.

GET /search/address/reverse/crossStreet/{format} Find the nearest cross street to a coordinate · Microsoft Azure Get Search Address Reverse Crossstreet Format #

Ask an LLM

“What is the nearest intersection to a given coordinate?”

“Can I get cross street names for a location instead of a full address?”

Tell an agent

Find the nearest cross street to {query}.

Get the intersection closest to {query} while heading {heading} degrees.

GET /search/address/structured/{format} Geocode an address given as separate fields · Microsoft Azure Get Search Address Structured Format #

Ask an LLM

“Can I geocode an address when I have street, city and postal code as separate fields?”

“Is a country code required for structured address lookup?”

Tell an agent

Geocode {streetNumber} {streetName}, {municipality} in country {countryCode}.

Look up postal code {postalCode} in country {countryCode} as a structured address.

POST /search/geometry/{format} Search for places inside a geometry · Microsoft Azure Post Search Geometry Format #

Ask an LLM

“How do I find places that fall inside a polygon or circle I draw?”

“Can I restrict a free-form search to one or more geometries?”

Tell an agent

Search for {query} inside the geometry {geometry}.

Find {query} within these shapes limited to {limit} results: {geometry}.

POST /search/alongRoute/{format} Find places along a driving route · Microsoft Azure Post Search Alongroute Format #

Ask an LLM

“Can I find gas stations along my route without a long detour?”

“How do I search points of interest on a route with a maximum detour time?”

Tell an agent

Find {query} along route {route} with at most {maxDetourTime} seconds of detour.

Search {query} on this route within a {maxDetourTime}-second detour: {route}.

POST /search/fuzzy/batch/{format} Run many free-form place searches in one batch · Microsoft Azure Post Search Fuzzy Batch Format #

Ask an LLM

“Can I send many fuzzy place searches in a single request?”

“What's the batch option for free-form search on the S1 tier?”

Tell an agent

Run this batch of fuzzy searches: {batchItems}.

Submit these free-form place queries as one batch and return {format}: {batchItems}.

POST /search/address/batch/{format} Geocode many addresses in one batch · Microsoft Azure Post Search Address Batch Format #

Ask an LLM

“How do I geocode a list of addresses at once?”

“Is there a batch version of address geocoding?”

Tell an agent

Geocode this batch of addresses: {batchItems}.

Batch-geocode these address queries as {format}: {batchItems}.

POST /search/address/reverse/batch/{format} Reverse geocode many coordinates in one batch · Microsoft Azure Post Search Address Reverse Batch Format #

Ask an LLM

“Can I reverse geocode a whole list of coordinates in one call?”

“Which endpoint turns many latitude/longitude pairs into addresses together?”

Tell an agent

Reverse geocode this batch of coordinates: {batchItems}.

Batch-convert these points to addresses as {format}: {batchItems}.

Microsoft Azure Search API

Operations 18

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification