GoGoDuk

Quickstart

Make your first API call in under a minute.

1. Get an API key

Sign in to the dashboard and click Create API key. Pick an environment (LIVE for production, SANDBOX for testing) and copy the returned key — it's only shown once.

Keys look like gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx.

2. Make a request

Use the key in the X-API-Key request header.

curl "https://api.gogoduk.com/v1/suggest?input=ho+chi+minh" \
  -H "X-API-Key: gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
const res = await fetch(
  "https://api.gogoduk.com/v1/suggest?input=ho+chi+minh",
  { headers: { "X-API-Key": process.env.GOGODUK_KEY! } }
);
const { predictions } = await res.json();
import os, requests
 
r = requests.get(
    "https://api.gogoduk.com/v1/suggest",
    params={"input": "ho chi minh"},
    headers={"X-API-Key": os.environ["GOGODUK_KEY"]},
)
print(r.json())

3. Inspect the response

Every response is JSON. Successful calls also return rate-limit headers:

X-RateLimit-Limit-Minute: 60
X-RateLimit-Remaining-Minute: 59
X-RateLimit-Limit-Day: 1000
X-RateLimit-Remaining-Day: 999
X-Request-ID: 8f0e1c54-...

Need a 1-click trial without signing up? The landing page demo at GoGoDuk calls /v1/demo/suggest directly (IP-rate-limited, no key required).

What's next

Previous

Introduction

Next

Authentication

On this page