{
  "name": "Azure Maps Search (POI)",
  "slug": "azure-maps-search",
  "website_url": "https://azure.microsoft.com/en-us/products/azure-maps",
  "vendor_description": "\"Azure Maps is a collection of geospatial services and SDKs that use fresh mapping data to provide geographic context to web and mobile applications.\"",
  "categories": [
    "places"
  ],
  "summary": "Azure Maps Search is a Microsoft geocoding and place-search REST API covering POI lookup, address autocomplete, reverse geocoding, and batch geocoding across 200+ countries, suited for web and mobile applications needing geographic context. Pricing is usage-based at $4.50 per 1,000 transactions with a 5,000 transaction free tier per month and self-serve signup. SDKs are available for JavaScript, Python, C#, and Java, with OAuth2 and API key auth supported. The service carries SOC 2 Type 2, ISO 27001, HIPAA, PCI DSS, and GDPR compliance, though address queries are shared with TomTom for mapping functionality and the service is not available by default in China or Korea.",
  "capabilities": {
    "supported_actions": [
      "get_geocode_autocomplete",
      "get_geocoding",
      "get_geocoding_batch",
      "get_polygon",
      "get_reverse_geocoding",
      "get_reverse_geocoding_batch"
    ],
    "supported_regions": [
      "Global - POI and city-level coverage across 200+ countries/territories; address-point coverage in select countries including US, Canada, UK, Australia, France, Germany, Brazil, and others; not available in China or Korea by default"
    ],
    "supported_languages": [
      "Afrikaans",
      "Albanian",
      "Amharic",
      "Arabic",
      "Armenian",
      "Assamese",
      "Azerbaijani",
      "Bangla",
      "Basque",
      "Belarusian",
      "Bosnian",
      "Bulgarian",
      "Burmese",
      "Catalan",
      "Central Kurdish",
      "Chinese (Simplified)",
      "Chinese (Traditional)",
      "Croatian",
      "Czech",
      "Danish",
      "Dari",
      "Dutch",
      "English",
      "Estonian",
      "Faroese",
      "Filipino",
      "Finnish",
      "French",
      "Galician",
      "Georgian",
      "German",
      "Greek",
      "Gujarati",
      "Hausa",
      "Hebrew",
      "Hindi",
      "Hungarian",
      "Icelandic",
      "Igbo",
      "Indonesian",
      "Irish",
      "isiXhosa",
      "isiZulu",
      "Italian",
      "Japanese",
      "Kannada",
      "Kazakh",
      "Khmer",
      "Kinyarwanda",
      "Kiswahili",
      "Konkani",
      "Korean",
      "Kyrgyz",
      "Latvian",
      "Lithuanian",
      "Luxembourgish",
      "Macedonian",
      "Malay",
      "Malayalam",
      "Maltese",
      "Maori",
      "Marathi",
      "Mongolian",
      "Nepali",
      "Norwegian",
      "Odia",
      "Persian",
      "Polish",
      "Portuguese",
      "Punjabi",
      "Quechua",
      "Romanian",
      "Russian",
      "Scottish Gaelic",
      "Serbian",
      "Sesotho sa Leboa",
      "Setswana",
      "Sindhi",
      "Sinhala",
      "Slovak",
      "Slovenian",
      "Spanish",
      "Swedish",
      "Tajik",
      "Tamil",
      "Tatar",
      "Telugu",
      "Thai",
      "Tibetan",
      "Tigrinya",
      "Turkish",
      "Turkmen",
      "Ukrainian",
      "Urdu",
      "Uyghur",
      "Uzbek",
      "Valencian",
      "Vietnamese",
      "Welsh",
      "Wolof",
      "Yoruba"
    ],
    "input_types": [
      "text query (place name, address, partial query)",
      "lat/lon coordinates",
      "bounding box",
      "country/region ISO code filter",
      "result type filter (Address, Place)",
      "place ID (for polygon lookup)"
    ],
    "output_types": [
      "GeoJSON (application/geo+json)",
      "JSON"
    ],
    "webhooks_supported": false,
    "sandbox_available": false,
    "sdk_languages": [
      "JavaScript/TypeScript",
      "Python",
      "C#/.NET",
      "Java"
    ],
    "mcp_server_available": false
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://atlas.microsoft.com",
    "api_version": "2026-01-01",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": null,
    "auth_methods": [
      "api_key",
      "oauth2"
    ],
    "auth_docs_url": "https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-authentication",
    "idempotency_supported": null,
    "error_format": "vendor-specific",
    "webhook_signing": null,
    "webhook_events_url": null,
    "rate_limit_requests": 500,
    "rate_limit_window": "second",
    "sdk_packages": [
      {
        "package": "@azure-rest/maps-search",
        "language": "JavaScript/TypeScript",
        "official": true,
        "repo_url": "https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/maps/maps-search-rest"
      },
      {
        "package": "azure-maps-search",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/maps/azure-maps-search"
      },
      {
        "package": "Azure.Maps.Search",
        "language": "C#/.NET",
        "official": true,
        "repo_url": "https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/maps/Azure.Maps.Search"
      },
      {
        "package": "azure-maps-search",
        "language": "Java",
        "official": true,
        "repo_url": "https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-search"
      }
    ],
    "mcp_url": null,
    "quickstart_url": "https://learn.microsoft.com/en-us/azure/azure-maps/quick-demo-map-app"
  },
  "pricing": {
    "pricing_model": "usage_based",
    "has_published_pricing": true,
    "starting_price_usd": "4.5000",
    "price_basis": "1,000 transactions",
    "free_tier_available": true,
    "free_tier_limit": "5,000 transactions/month",
    "free_tier_details": "First 5,000 Location Insights Search transactions per month are free (recurring monthly allowance, resets each month). Gen2 pricing tier required.",
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": false,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Gen2",
        "item": "Location Insights Search (POI/Geocoding) transactions",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "first 5,000 transactions/month",
        "currency": "USD",
        "source_url": "https://azure.microsoft.com/en-us/pricing/details/azure-maps/"
      },
      {
        "plan": "Gen2",
        "item": "Location Insights Search (POI/Geocoding) transactions",
        "amount_usd": "4.5000",
        "amount_percent": null,
        "per": "1,000 transactions (5,001–100,000/month)",
        "currency": "USD",
        "source_url": "https://azure.microsoft.com/en-us/pricing/details/azure-maps/"
      },
      {
        "plan": "Gen2",
        "item": "Location Insights Search (POI/Geocoding) transactions",
        "amount_usd": "3.0000",
        "amount_percent": null,
        "per": "1,000 transactions (100,001–500,000/month)",
        "currency": "USD",
        "source_url": "https://azure.microsoft.com/en-us/pricing/details/azure-maps/"
      },
      {
        "plan": "Gen2",
        "item": "Location Insights Search (POI/Geocoding) transactions",
        "amount_usd": "1.5000",
        "amount_percent": null,
        "per": "1,000 transactions (500,001–1,000,000/month)",
        "currency": "USD",
        "source_url": "https://azure.microsoft.com/en-us/pricing/details/azure-maps/"
      },
      {
        "plan": "Gen2",
        "item": "Location Insights Search (POI/Geocoding) transactions",
        "amount_usd": "0.5000",
        "amount_percent": null,
        "per": "1,000 transactions (1,000,001+/month)",
        "currency": "USD",
        "source_url": "https://azure.microsoft.com/en-us/pricing/details/azure-maps/"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": true,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": true,
    "sla_url": "https://azure.microsoft.com/en-us/support/legal/sla/azure-maps/",
    "data_retention_policy_url": "https://www.microsoft.com/en-us/trust-center/privacy/data-management",
    "documented_rate_limits": "Search service - single request: 500 QPS (Gen2); Search service - single request reverse: 250 QPS (Gen2); Search service - single request geocode autocomplete: 100 QPS (Gen2); Search service - Batch: 10 QPS (Gen2); HTTP 429 returned when QPS limits exceeded; QPS limits can be increased via Azure support request for Gen2",
    "known_restrictions": [
      "Azure Maps shares customer-provided address/location queries with third-party TomTom for mapping functionality purposes",
      "Queries are not linked to any customer or end user when shared with TomTom",
      "Service not available in China or Korea by default (data residency/processing consent required for Korea)",
      "The View parameter must be configured in compliance with applicable local laws regarding geopolitically disputed borders",
      "Display of Render service results requires showing appropriate copyright attribution",
      "Gen1 pricing tier deprecated and will be retired on 9/15/26",
      "SAS tokens have maximum lifetime of 24 hours",
      "Data residency limited to EU or US geographic endpoints (eu.atlas.microsoft.com or us.atlas.microsoft.com)"
    ]
  },
  "developer": {
    "docs_url": "https://azure.microsoft.com/developer",
    "api_reference_url": null,
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": null,
    "llms_txt_url": "https://azure.microsoft.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2018-05-07",
    "ga_date": "2018-05-07",
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": []
  },
  "scores": {
    "agent_friendliness": 45,
    "pricing_transparency": 100,
    "setup_speed": 85,
    "docs_quality": 25,
    "procurement_friction": 100,
    "trust_readiness": 100,
    "best_for": [
      "Prototypes and side projects - free to start, no sales call",
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)"
    ],
    "avoid_if": []
  },
  "sources": [
    {
      "field": "sla_published",
      "url": "https://azure.microsoft.com/en-us/support/legal/sla/azure-maps/v1_0/",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search",
      "excerpt": "Get Geocode Autocomplete | Get Geocoding | Get Geocoding Batch | Get Polygon | Get Reverse Geocoding | Get Reverse Geocoding Batch",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://learn.microsoft.com/en-us/azure/event-grid/event-schema-azure-maps",
      "excerpt": "An Azure Maps account emits the following event types: Microsoft.Maps.GeofenceEntered | Microsoft.Maps.GeofenceExited | Microsoft.Maps.GeofenceResult",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/understanding-azure-maps-transactions",
      "excerpt": "These transactions can be either billable or nonbillable usage, depending on the service and the feature.",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/understanding-azure-maps-transactions",
      "excerpt": "Azure Maps offers many free transactions each month as shown in Azure Maps pricing. For example, you get 5,000 free Base Map Tile transactions per month.",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://azure.microsoft.com/nb-no/updates/azure-maps-is-now-hipaa-health-insurance-portability-and-accountability-act-compliant/",
      "excerpt": "Azure Maps is now HIPAA (Health Insurance Portability and Accountability Act) compliant",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://learn.microsoft.com/en-us/azure/compliance/offerings/offering-soc-2",
      "excerpt": "Microsoft Azure, Dynamics 365, and other Microsoft cloud services undergo rigorous independent third-party SOC 2 Type 2 audits conducted by a reputable certified public accountant (CPA) firm.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://learn.microsoft.com/en-us/azure/compliance/offerings/offering-pci-dss",
      "excerpt": "Microsoft Azure is validated as compliant under PCI DSS version 4.0 at Service Provider Level 1, the highest level of compliance available for service providers.",
      "confidence": "medium"
    },
    {
      "field": "vendor_description",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/about-azure-maps",
      "excerpt": "Azure Maps is a collection of geospatial services and SDKs that use fresh mapping data to provide geographic context to web and mobile applications.",
      "confidence": "high"
    },
    {
      "field": "output_types",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocode-autocomplete",
      "excerpt": "200 OK | AutocompleteResponse | The request has succeeded. Media Types: \"application/geo+json\", \"application/json\"",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://learn.microsoft.com/en-us/answers/questions/1183391/billing-azure-maps-gen2-minimum-usage-(dev)-daily",
      "excerpt": "Azure Maps is generally a pay as you go service, so if one month you use 100K transactions, zero the next, you would only pay for the 100K transactions you used the first month, nothing the second month.",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://learn.microsoft.com/en-us/answers/questions/1354649/azure-maps-gen-2-location-insights-search-pricing",
      "excerpt": "First 5,000 requests per month are free",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/understanding-azure-maps-transactions",
      "excerpt": "For Azure Maps pricing information and free offering details, see Azure Maps Pricing (https://azure.microsoft.com/pricing/details/azure-maps/).",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://learn.microsoft.com/en-us/azure/compliance/offerings/offering-hipaa-us",
      "excerpt": "Azure has enabled the physical, technical, and administrative safeguards required by HIPAA and the HITECH Act inside the in-scope Azure services, and offers a HIPAA BAA as part of the Microsoft Product Terms to all customers who are covered entities or business associates under HIPAA for use of such in-scope Azure services.",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://learn.microsoft.com/en-us/azure/compliance/offerings/offering-iso-27001",
      "excerpt": "Microsoft Azure, Dynamics 365, and other Microsoft online services undergo regular independent third-party audits for ISO/IEC 27001 compliance.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/about-azure-maps",
      "excerpt": "TomTom is a subprocessor that is authorized to subprocess Azure Maps customer data. For more information, see the Microsoft Online Services Subprocessor List located in the Microsoft Trust Center.",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/ea-pricing-overview",
      "excerpt": null,
      "confidence": "medium"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-qps-rate-limits",
      "excerpt": "Search service - single request | 500 | 500 | 50 ... Search service - single request reverse | 250 | 250 | 50 ... Search service - single request geocode autocomplete | 100 | Not Applicable | Not Applicable ... Search service - Batch | 10 | 10 | Not Available",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/rest-sdk-developer-guide",
      "excerpt": "the Azure Maps team has encapsulated their REST API in SDKs for C# (.NET), Python, JavaScript/TypeScript, and Java.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/about-azure-maps",
      "excerpt": "Azure Maps services are currently available except in the following countries/regions: China, Korea",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search",
      "excerpt": "API Version: 2026-01-01",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocoding",
      "excerpt": "The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud.",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocoding",
      "excerpt": "GET {endpoint}/geocode?api-version=2026-01-01",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocoding",
      "excerpt": "These are the Microsoft Entra OAuth 2.0 Flows. When paired with Azure role-based access control it can be used to control access to Azure Maps REST APIs.",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-qps-rate-limits",
      "excerpt": "Azure Maps doesn't have any maximum daily limits on the number of requests that can be made, however there are limits to the maximum number of queries per second (QPS).",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://learn.microsoft.com/en-us/answers/questions/1372918/some-questions-about-azure-maps-pricing-and-azure",
      "excerpt": "Search service at $4.50 per 1000 transactions",
      "confidence": "medium"
    },
    {
      "field": "free_tier_limit",
      "url": "https://learn.microsoft.com/en-us/answers/a/1307052",
      "excerpt": "First 5,000 requests per month: Free ... Additional requests: £3.51 per 1,000 requests",
      "confidence": "medium"
    },
    {
      "field": "launched_at",
      "url": "https://azure.microsoft.com/en-us/updates/azure-maps-now-generally-available/",
      "excerpt": "Azure Maps now Generally Available",
      "confidence": "medium"
    },
    {
      "field": "stability",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search",
      "excerpt": "API Version: 2026-01-01",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/README.md",
      "excerpt": "Azure Maps is notably absent [from the supported services list of 43+ Azure service areas in the Azure MCP Server]",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/quick-demo-map-app",
      "excerpt": "Quickstart: Interactive map search with Azure Maps - Microsoft Azure Maps | Microsoft Learn",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search",
      "excerpt": "GET {endpoint}/geocode?api-version=2026-01-01",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/about-azure-maps",
      "excerpt": "Azure Maps shares customer-provided address/location queries with third-party TomTom for mapping functionality purposes. These queries aren't linked to any customer or end user when shared with TomTom and can't be used to identify individuals.",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/about-azure-maps",
      "excerpt": "Search services to locate addresses, places, and points of interest around the world... Search along a route. Search inside a wider area. Batch a group of search requests. Search electric vehicle charging stations and Point of Interest (POI) data by brand name.",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocoding",
      "excerpt": "GET {endpoint}/geocode?api-version=2026-01-01",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/how-to-search-for-address",
      "excerpt": "GET https://atlas.microsoft.com/geocode?api-version=2026-01-01&subscription-key={Your-Azure-Maps-Subscription-key}&query=400 Broad St, Seattle, WA 98109",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-authentication",
      "excerpt": "Azure Maps supports three authentication methods: Shared Key, Microsoft Entra ID, and Shared Access Signature (SAS) Token.",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-qps-rate-limits",
      "excerpt": "Search service - single request | 500 | 500 | 50",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/rest-sdk-developer-guide",
      "excerpt": "Search | @azure-rest/maps-search | search samples ... Search | azure-maps-search (PyPi) ... Search | Azure.Maps.Search (NuGet) ... Search | azure-maps-search (Maven)",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/understanding-azure-maps-transactions",
      "excerpt": "For example, you get 5,000 free *Base Map Tile* transactions per month.",
      "confidence": "medium"
    },
    {
      "field": "price_basis",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/understanding-azure-maps-transactions",
      "excerpt": "One request = 1 transaction ... When using Geocode Autocomplete, every 10 autocomplete requests count as one billable Search transaction.",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://azure.microsoft.com/en-us/updates/azure-maps-now-generally-available/",
      "excerpt": "Azure Maps now Generally Available",
      "confidence": "medium"
    },
    {
      "field": "error_format",
      "url": "https://learn.microsoft.com/en-us/rest/api/maps/search/get-geocoding",
      "excerpt": "Azure.Core.Foundations.ErrorResponse | A response containing error details ... code | string | One of a server-defined set of error codes. | message | string | A human-readable representation of the error.",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://www.microsoft.com/en-us/trust-center/privacy/data-management",
      "excerpt": "If you terminate a cloud subscription or it expires (except for free trials), Microsoft will store your customer data in a limited-function account for 90 days (the 'retention period').",
      "confidence": "medium"
    },
    {
      "field": "requires_verification",
      "url": "https://learn.microsoft.com/en-us/azure/azure-maps/quick-demo-map-app",
      "excerpt": "Create a new Azure Maps account ... Select Create a resource in the upper left-hand corner of the Azure portal ... Select Azure Maps account ... select the Create button.",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "total_poi_count",
    "deprecation_policy_url",
    "mcp_url",
    "idempotency_supported",
    "webhook_signing",
    "webhook_events_url",
    "notable_customers",
    "ga_date_exact_source"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-14T00:00:00.000Z",
  "contribute": {
    "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.",
    "endpoints": [
      {
        "action": "review",
        "label": "Leave a review or comment",
        "method": "POST",
        "url": "https://apio.sh/api/feedback/azure-maps-search",
        "example_body": {
          "kind": "review",
          "rating": 5,
          "body": "Your experience with this API…"
        }
      },
      {
        "action": "field_edit",
        "label": "Suggest a correction to a field (cite a source)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/azure-maps-search/{field}",
        "example_body": {
          "value": "corrected value",
          "citations": [
            {
              "url": "https://source.example/page",
              "excerpt": "supporting quote"
            }
          ],
          "note": "what changed and why"
        }
      },
      {
        "action": "new_api",
        "label": "Suggest a new API to add",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme API",
            "website_url": "https://acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example"
            }
          ]
        }
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}