# Countries — AutoSugges platform dataset

## How do I add Countries autocomplete to my app?

Countries is a free AutoSugges reference list of 249 items. Query it with your publishable key as the key parameter and the typed text as q, after at least two characters. Results come back pre-ranked from the edge, ten by default, ready for the AutoSugges React, React Native or HTML component.

ISO 3166-1 countries — 249 officially assigned codes, with alpha-2, alpha-3 and numeric aliases and a computed flag.

249 items.

## Provenance
Source: Unicode CLDR via Node ICU (https://cldr.unicode.org/)
Retrieved: 2026-09-23, effective version ISO 3166-1, current edition; country names from whichever CLDR release ships with the Node.js runtime that generated this file — there is no separate version to pin.
Authority: authoritative
Licence: Unicode License v3 (SPDX `Unicode-3.0`) — permissive, attribution requested rather than required (unicode.org/license.txt). ISO 3166-1 codes are treated as facts, not a licensed corpus, for the same reason datasets/naics/spec.mjs gives for NAICS codes. (other)
Attribution: Country names: Unicode CLDR (Common Locale Data Repository), bundled with Node.js. Country codes: ISO 3166-1.
Export allowed: yes

## Availability
Free

## Authority
Authoritative

## Dataset kind
Reference list

## Worked example
```json
{
  "value": "United States",
  "displayValue": "United States",
  "aliases": [
    "US",
    "USA"
  ],
  "metadata": {
    "alpha2": "US",
    "alpha3": "USA",
    "numeric": "840",
    "flag": "🇺🇸"
  }
}
```

## Query it
```
/v1/query?key=YOUR_PUBLISHABLE_KEY&q=uni
```

A publishable key is public by design and belongs in client code as written; it is not a secret.

## Frequently asked questions

### What is in the Countries dataset?

ISO 3166-1 countries — 249 officially assigned codes, with alpha-2, alpha-3 and numeric aliases and a computed flag. It has 249 items. Its source is Unicode CLDR via Node ICU. Authority: Authoritative. Licence: Unicode License v3 (SPDX `Unicode-3.0`) — permissive, attribution requested rather than required (unicode.org/license.txt). ISO 3166-1 codes are treated as facts, not a licensed corpus, for the same reason datasets/naics/spec.mjs gives for NAICS codes. Refresh cadence: As needed — ISO 3166-1 assigns a new code roughly once every few years, and CLDR name data changes only when the Node.js runtime that generates this file is upgraded.

### Is the Countries dataset free?

AutoSugges-published free datasets are never priced on their own — every plan includes all of them. What a plan prices is how many queries you may make, not which free list you may query. A few catalog entries are licensed from a third party or supplied by you, and those carry their own access terms, shown on that dataset's own page.

### How do I query Countries?

Call GET /v1/query with your publishable key as the key parameter and the typed text as q, or mount the AutoSugges component for React, React Native or HTML. The runtime answers from the edge and never reads a database.

### What is the minimum number of characters before a query runs?

Two by default. A list owner can change the minimum, but it can never be 1. The client reads the real value from bootstrap and sends no request below it, so do not hardcode it.

### How long does the client wait after typing before it queries?

150 milliseconds by default. The value is delivered through bootstrap and a list owner can raise it, so the client uses the policy value rather than a constant.

### What happens when my query quota runs out?

The runtime returns a structured quota_exceeded response that carries no items and no placeholder suggestions, so exhaustion is never mistaken for no results. Render it from the typed error code and prompt an upgrade.

---
Canonical page: https://autosugges.com/datasets/countries