Sidebar

Mobile navigation sidebar

Developer console

Python

Call the Address Suggest API from Python using urllib (stdlib) or requests.

Using urllib (stdlib)

import os
import urllib.request
import urllib.parse

API_URL = os.getenv("DATASARAS_API_URL", "https://api.datasaras.com")
API_KEY = os.getenv("DATASARAS_API_KEY")

def address_suggest(keyword: str, limit: int = 10) -> dict:
    params = urllib.parse.urlencode({"keyword": keyword, "limit": limit})
    url = f"{API_URL}/address-api-v1/au/address/suggest?{params}"

    req = urllib.request.Request(url, headers={"x-auth-key": API_KEY})
    with urllib.request.urlopen(req) as resp:
        if resp.status != 200:
            raise RuntimeError(f"API error: {resp.status}")
        import json
        return json.loads(resp.read().decode())

# Usage
result = address_suggest("55 kay st", 10)
print(result["items"])

Using requests

import os
import requests

API_URL = os.getenv("DATASARAS_API_URL", "https://api.datasaras.com")
API_KEY = os.getenv("DATASARAS_API_KEY")

def address_suggest(keyword: str, limit: int = 10) -> dict:
    response = requests.get(
        f"{API_URL}/address-api-v1/au/address/suggest",
        params={"keyword": keyword, "limit": limit},
        headers={"x-auth-key": API_KEY},
    )
    response.raise_for_status()
    return response.json()

# Usage
result = address_suggest("55 kay st", 10)
print(result["items"])

Environment variables

export DATASARAS_API_URL=https://api.datasaras.com
export DATASARAS_API_KEY=your_api_key

Endpoint

GET http://localhost:8383/address-api-v1/au/address/suggest?keyword=…&limit=10

Header: x-auth-key: YOUR_API_KEY