completion: Address autocomplete

API: gouv.fr:api-adresse
Endpoint: /completion
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 310ms

Description

Returns a list of address suggestions based on partial text input. Optimized for real-time autocomplete UI with faster response than full search. Each result includes the full formatted address, street, city, postal code, and coordinates.

From spec: Get address completion suggestions for partial input. Useful for autocomplete UI components.

Usage Tips

- Use 'text' parameter (not 'q' like /search) - Optimized for low-latency autocomplete UIs - Returns fewer fields than /search but faster response - Best for type-ahead address entry fields

Parameters (3)

limit (integer, query, optional, default: 10)

Maximum number of suggestions

Constraints: {'minimum': 1, 'maximum': 20}

text (string, query, required)

Partial address text to complete

type (string, query, optional)

Filter by result type

Constraints: {'enum': ['StreetAddress', 'PositionOfInterest']}

Examples (1)

Autocomplete address suggestions probe-gate

Demonstrates real-time autocomplete for partial address input

curl 'https://api-adresse.data.gouv.fr/completion?text=8+bd+du+port'
import requests

resp = requests.get(
    "https://api-adresse.data.gouv.fr/completion",
    params={
        'text': '8 bd du port',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("api-adresse")
result = api.fetch("completion", text="8 bd du port")

for item in result:
    print(item)
const resp = await fetch("https://api-adresse.data.gouv.fr/completion?text=8+bd+du+port");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 16:41:28.465783 200 310ms
2026-04-16 01:28:05.702943 200 320ms
2026-04-15 01:19:37.278185 200 317ms
2026-04-14 02:36:44.931817 200 330ms
2026-04-12 16:37:50.288403 200 322ms
2026-04-10 02:35:09.025993 200 302ms
2026-04-09 02:11:30.946559 200 242ms