Dragon Kids Land for AI assistants
What an assistant can do
Play Places
1,405 places to play with kids in 179 countries and 380 cities: indoor play centres, trampoline parks, kids' cafés, children's museums and named playgrounds.
- Search by city, country, or around a point with a radius
- Open now, worked out in each place's own time zone
- Indoors, free entry, wheelchair access, website, phone
- Our published ranking, distance or A–Z
Songs
21 original songs for babies, toddlers and preschoolers, one for each part of the day.
- By routine: teeth, bath, potty, food, bedtime, dance
- The lyrics and the moves, step by step
- Release dates, pre-save and listening links
Stories
18 retold fairy tales, fables and folk tales for ages 3 to 12, 18 with a narration to listen to.
- Filter by age, length and scariness (0 to 3)
- The moral, the characters and discussion questions
- The text in parts, ready to read aloud
Questions it can answer
Each one is a recipe in chatgpt-workflows.md.
“Find an indoor play place in Lisbon that is open now.”
GET /api/v1/ai/places?country=pt&city=Lisbon&indoor=true&openNow=trueIndoor places open at this moment, in Lisbon's own time zone, in our published ranking order.GET /api/v1/ai/places/{id}For the one the user picks: the address, today's hours, closing time and map links.
“Where can I take my kids to play near me?”
GET /api/v1/ai/places?lat=38.7223&lng=-9.1393&radiusKm=5&sort=distanceWith coordinates: places within 5 km, nearest first. Widen radiusKm (up to 100) if nothing comes back.GET /api/v1/ai/places?country=pt&city=PortoWith only a city name: the city's list in our ranking order.
“It's raining in Madrid. Anything free and indoors for a 4-year-old?”
GET /api/v1/ai/places?country=es&city=Madrid&indoor=true&free=trueIndoor places marked free.GET /api/v1/ai/places?country=es&city=Madrid&category=childrens_museum,indoor_playIf the free list is short: museums and indoor play, with entry fees possible.
“A calm bedtime song for my 2-year-old.”
GET /api/v1/ai/songs?routine=bedtime&age=2&calm=trueCalm songs whose age range includes 2.GET /api/v1/ai/songs/{slug}The lyrics, the listening sample and the YouTube or streaming links once released.
“My toddler hates brushing teeth. Is there a song for that?”
GET /api/v1/ai/songs?q=teeth&age=2Typo-tolerant search ("teth" works too).GET /api/v1/ai/songs/{slug}The moves step by step and the notes for grown-ups with their sources.
“A 5-minute story for a 4-year-old that isn't scary, one we can listen to.”
GET /api/v1/ai/stories?age=4&maxScariness=1&hasAudio=true&sort=shortestGentle stories with a narration, shortest first.GET /api/v1/ai/stories/{slug}audio.short is the 5-minute narration; audio.full the whole story.
The API
Base URL https://dragonkidsland.com. Every endpoint is a GET that returns JSON with absolute links. No account or key, CORS open to every site, 120 requests per minute per IP address (then 429 with Retry-After). Responses can be cached; Play Places answers that depend on “open now” are kept for a minute only.
| Endpoint | What it returns |
|---|---|
/api/v1/ai/capabilities | What Dragon Kids Land offers |
/api/v1/ai/search | Search songs, stories, places and cities |
/api/v1/ai/songs | Find original songs for kids |
/api/v1/ai/songs/{slug} | One song: lyrics, moves, notes, links |
/api/v1/ai/stories | Find fairy tales and fables to read |
/api/v1/ai/stories/{slug} | One story: moral, characters, audio, video |
/api/v1/ai/stories/{slug}/text | The story text, in parts |
/api/v1/ai/places | Find places to play with kids |
/api/v1/ai/places/{id} | One place: address, hours, map, ranking |
/api/v1/ai/places/countries | Countries with listed places |
/api/v1/ai/places/countries/{country}/cities | Cities of a country with listed places |
/api/v1/ai/places/how-we-rank | How Play Places are ranked |
/api/v1/ai/changelog | What changed in this API |
Every answer has the same shape
{
"data": [ ... ],
"pagination": { "limit": 10, "total": 42, "nextCursor": "bzoxMA", "hasMore": true },
"meta": { "canonicalUrl": "https://dragonkidsland.com/play-places/portugal/lisbon", "attribution": "Source: Dragon Kids Land ..." },
"links": { "self": "...", "next": "...", "openapi": "https://dragonkidsland.com/openapi.json" },
"suggestedNext": [ { "label": "...", "url": "..." } ]
}Lists take limit (up to 50) and cursor; pass pagination.nextCursor back to get the next page. A mistake returns 400 or 404 with error.hint, which says how to fix it, for example the city names we know. Place categories: indoor_play (indoor play centre), trampoline_park (trampoline park), kids_cafe (kids' café), childrens_museum (children's museum), activity_venue (kids' activity venue), playground (playground).
Use it in ChatGPT
In a custom GPT, add an Action, choose Import from URL and paste the address below. Authentication: none. Privacy policy: https://dragonkidsland.com/privacy.
https://dragonkidsland.com/openapi.jsonOther assistants that can read the web can start from llms.txt or call the endpoints directly.
Citing us, and keeping it right for kids
- Link to the page in meta.canonicalUrl (or the item's url) whenever you use our content.
- Never invent a song, story or place. If the API does not return it, say we do not have it.
- For Play Places, ask for a city or a location when someone says "near me" without one. Never guess where the user is.
- Opening hours come from public map data and change: say "open now" only from openNow, and suggest checking with the place.
- Credit venue data as "© OpenStreetMap contributors (ODbL)".
- Keep it suitable for families: our songs and stories are written for children aged 0 to 12 and the grown-ups with them.
- Notes for grown-ups on baby and health songs are general information with official sources, not medical advice.
The songs are original songs and the lyrics are original. The stories are our own retellings of public-domain tales. Play Places uses OpenStreetMap data (© OpenStreetMap contributors, ODbL) and no ratings, reviews or payments; partner venues are listed first and always labelled.
Documents for assistants
- openapi.jsonOpenAPI 3.1, ready to import as ChatGPT Actions
- chatgpt-workflows.mdStep-by-step recipes for common questions
- llms.txtA short overview for language models
- llms-full.txtEverything in one file: songs with lyrics, stories, countries and cities
- ai-changelog.mdWhat changed, with dates
- How we rank Play PlacesThe ranking rules, in full
Contact
Building something with this, or need more than 120 requests a minute? Write to [email protected].