# Dragon Kids Land: workflows for ChatGPT and other assistants

> Concrete recipes for answering parents with Dragon Kids Land: Play Places (where to play with kids), original songs for little ones, and retold fairy tales and fables. All calls are GET, need no key, and return JSON with absolute URLs.

Base URL: https://dragonkidsland.com. API reference: https://dragonkidsland.com/openapi.json. Guide: https://dragonkidsland.com/ai. Rate limit: 120 requests per minute per IP.

Try it in ChatGPT: https://chatgpt.com/g/g-6ade4d68bfd88191acbb8035f8900e53-dragon-kids-land-play-places-songs-stories

## Rules

- 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.

## Workflow 1: An indoor play place in a city, open now

**The user asks:** "Find an indoor play place in Lisbon that is open now."

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/places?country=pt&city=Lisbon&indoor=true&openNow=true`: Indoor places open at this moment, in Lisbon's own time zone, in our published ranking order.
2. `GET https://dragonkidsland.com/api/v1/ai/places/{id}`: For the one the user picks: the address, today's hours, closing time and map links.

**Answer:** Give two or three places with the closing time (closesAt), the address and the link to each place page. Say that hours come from public map data and can change. If nothing is open, drop openNow=true and say which places open later.

## Workflow 2: Places to play "near me"

**The user asks:** "Where can I take my kids to play near me?"

**Steps:**

1. `(no call yet)`: Without a location, ask for the city or neighbourhood, or for a shared location. Never guess.
2. `GET https://dragonkidsland.com/api/v1/ai/places?lat=38.7223&lng=-9.1393&radiusKm=5&sort=distance`: With coordinates: places within 5 km, nearest first. Widen radiusKm (up to 100) if nothing comes back.
3. `GET https://dragonkidsland.com/api/v1/ai/places?country=pt&city=Porto`: With only a city name: the city's list in our ranking order.

**Answer:** List the nearest places with distanceKm, category and a link. Mention partner venues are labelled Partner.

## Workflow 3: A rainy-day plan that costs nothing

**The user asks:** "It's raining in Madrid. Anything free and indoors for a 4-year-old?"

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/places?country=es&city=Madrid&indoor=true&free=true`: Indoor places marked free.
2. `GET https://dragonkidsland.com/api/v1/ai/places?country=es&city=Madrid&category=childrens_museum,indoor_play`: If the free list is short: museums and indoor play, with entry fees possible.

**Answer:** Be clear about which places are marked free and which may charge. Link each place page.

## Workflow 4: A bedtime song for a 2-year-old

**The user asks:** "A calm bedtime song for my 2-year-old."

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/songs?routine=bedtime&age=2&calm=true`: Calm songs whose age range includes 2.
2. `GET https://dragonkidsland.com/api/v1/ai/songs/{slug}`: The lyrics, the listening sample and the YouTube or streaming links once released.

**Answer:** Name the song, quote a line or two of the lyrics, and link the song page. If it is not out yet, give the release date and the pre-save link.

## Workflow 5: A song that helps with a routine

**The user asks:** "My toddler hates brushing teeth. Is there a song for that?"

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/songs?q=teeth&age=2`: Typo-tolerant search ("teth" works too).
2. `GET https://dragonkidsland.com/api/v1/ai/songs/{slug}`: The moves step by step and the notes for grown-ups with their sources.

**Answer:** Explain how to use the song (the moves), keep health advice to what the grown-ups notes say and link the sources. It is not medical advice.

## Workflow 6: A 5-minute story that is not scary, with audio

**The user asks:** "A 5-minute story for a 4-year-old that isn't scary, one we can listen to."

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/stories?age=4&maxScariness=1&hasAudio=true&sort=shortest`: Gentle stories with a narration, shortest first.
2. `GET https://dragonkidsland.com/api/v1/ai/stories/{slug}`: audio.short is the 5-minute narration; audio.full the whole story.

**Answer:** Give the title, the summary in one sentence, the moral, and the link to the story page where the narration plays.

## Workflow 7: Read a story aloud in the chat

**The user asks:** "Read me The Three Little Pigs."

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/stories/the-three-little-pigs/text?version=short&part=1`: The short retelling as plain text. Follow nextPartUrl until it is null.

**Answer:** Read the text as given, without changing the story, and end with the link to the story page.

## Workflow 8: Which songs are coming out soon

**The user asks:** "When do the new dragon songs come out?"

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/songs?released=false&sort=recommended`: Songs not out yet, each with releaseDate and preSaveUrl.

**Answer:** List titles with their release dates and pre-save links. Do not promise a date we have not published.

## Workflow 9: Why is a place ranked first?

**The user asks:** "Why is this place at the top of your list?"

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/places/{id}`: ranking.explanation and ranking.breakdown for that place.
2. `GET https://dragonkidsland.com/api/v1/ai/places/how-we-rank`: The full published rules.

**Answer:** Explain partners-first (labelled) and the score from public data. We use no ratings, reviews or payments.

## Workflow 10: A story and a song that go together

**The user asks:** "Something for bath time: a song and a short story."

**Steps:**

1. `GET https://dragonkidsland.com/api/v1/ai/search?q=bath`: Songs, stories and places in one call.
2. `GET https://dragonkidsland.com/api/v1/ai/songs/{slug}`: relatedStories lists the stories that pair with the song.

**Answer:** Suggest one song and one story, each with its link.

## Tips

- Start with `GET /api/v1/ai/search?q=...` when the request is vague, or `GET /api/v1/ai/capabilities` to see what exists.
- Lists are paged: pass `pagination.nextCursor` back as `cursor`.
- A 400 or 404 response has `error.hint`, which says how to fix the call (for example the city names we know).
- Use `suggestedNext` for a natural next step.
- Categories for places: indoor_play, trampoline_park, kids_cafe, childrens_museum, activity_venue, playground.

## Contact

hello@dragonkidsland.com