Developer guide
How can I turn travel videos into saved places and an itinerary?
Send a travel video to mamitsu and get every place it recommends, in order, with the neighborhood and what to do there. Your app turns the list into saved places, a map or a day-by-day plan.
Start with a video
Ask for the places a video recommends
Travel videos are full of places that are only shown or said out loud: a cafe on a corner, a viewpoint at the top of a hill, the bakery the narrator says to look for. Send a public travel video from YouTube, TikTok, Instagram or X to mamitsu and ask for the places it recommends.
This request has no schema, so mamitsu chooses the structure from the prompt. Add a schema when your app needs fixed field names for every saved place.
: "${XTRAKT_USER_API_KEY:?Set XTRAKT_USER_API_KEY to your mamitsu API key}"
curl https://usemamitsu.com/api/v1/extract \
-H "Authorization: Bearer $XTRAKT_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.youtube.com/watch?v=utgbGMpZndw",
"prompt": "List every place this video recommends in Lisbon, in the order it appears. For each one give the neighborhood, what kind of place it is, and what the video says to do or see there."
}'A real example
A Lisbon guide, as 23 saved places
This is the full response for a Lisbon neighborhood guide on YouTube. mamitsu returns 23 places across six neighborhoods, from the Rua Augusta Arch in Baixa to Belém Tower, in the order the video visits them.
Each place comes with what the video suggests doing there, such as “Eat a warm bifana” at Bifanas do Afonso or “Spend an hour or two browsing” at Ler Devagar. That is the part people remember from a video and want to keep.
{
"extraction_id": "ext_7d153849-7014-4206-813f-fafab867e80a",
"data": {
"recommended_places": [
{
"name": "Baixa",
"neighborhood": "Baixa",
"type": "Neighborhood",
"recommendations": [
"Walk beneath the Rua Augusta Arch",
"Climb to the top of the Rua Augusta Arch for sweeping views"
]
},
{
"name": "Praça do Comércio",
"neighborhood": "Baixa",
"type": "Plaza",
"recommendations": [
"Visit as a grand stage for your first steps into the city"
]
},
{
"name": "Rua Augusta",
"neighborhood": "Baixa",
"type": "Boulevard",
"recommendations": [
"Shop"
]
},
{
"name": "Rossio Square",
"neighborhood": "Baixa",
"type": "Plaza",
"recommendations": [
"Explore the side streets filled with great places to shop and eat"
]
},
{
"name": "O Mundo Fantástico",
"neighborhood": "Baixa",
"type": "Shop",
"recommendations": [
"Pop in to see the city's love of sardines"
]
},
{
"name": "Santa Justa Elevator",
"neighborhood": "Baixa",
"type": "Elevator",
"recommendations": [
"Use as a way to get to the next neighborhood"
]
},
{
"name": "Carmo Convent",
"neighborhood": "Chiado",
"type": "Landmark",
"recommendations": [
"Visit to see the skeletal arches"
]
},
{
"name": "Rua Garrett",
"neighborhood": "Chiado",
"type": "Street",
"recommendations": [
"Explore boutiques and heritage shops",
"Visit one of Lisbon's most iconic cafes"
]
},
{
"name": "A Brasileira",
"neighborhood": "Chiado",
"type": "Cafe",
"recommendations": [
"Try Portuguese tarts and cappuccinos"
]
},
{
"name": "Miradouro de São Pedro de Alcântara",
"neighborhood": "Bairro Alto",
"type": "Viewpoint",
"recommendations": [
"Enjoy postcard-perfect views over Lisbon"
]
},
{
"name": "Tram 28",
"neighborhood": "Alfama",
"type": "Tram",
"recommendations": [
"Ride to discover Alfama"
]
},
{
"name": "Lisbon Cathedral",
"neighborhood": "Alfama",
"type": "Cathedral",
"recommendations": [
"Visit the stone chapels"
]
},
{
"name": "Miradouro de Santa Luzia",
"neighborhood": "Alfama",
"type": "Viewpoint",
"recommendations": [
"Enjoy the views across Alfama's jumble of rooftops"
]
},
{
"name": "Castelo de São Jorge",
"neighborhood": "Alfama",
"type": "Castle",
"recommendations": [
"Follow the laneways uphill to visit"
]
},
{
"name": "Bifanas do Afonso",
"neighborhood": "Alfama",
"type": "Restaurant",
"recommendations": [
"Eat a warm bifana"
]
},
{
"name": "Fado House",
"neighborhood": "Alfama",
"type": "Restaurant",
"recommendations": [
"Book a spot for a meal"
]
},
{
"name": "LX Factory",
"neighborhood": "Alcântara",
"type": "Creative Village",
"recommendations": [
"Look for crafts, clothing, and creations from Lisbon's up-and-coming designers"
]
},
{
"name": "Ler Devagar",
"neighborhood": "Alcântara",
"type": "Bookstore",
"recommendations": [
"Spend an hour or two browsing"
]
},
{
"name": "LX Market",
"neighborhood": "Alcântara",
"type": "Market",
"recommendations": [
"Visit on Sundays"
]
},
{
"name": "Jerónimos Monastery",
"neighborhood": "Belém",
"type": "Monastery",
"recommendations": [
"Visit the star of Belém"
]
},
{
"name": "Pastéis de Belém",
"neighborhood": "Belém",
"type": "Bakery",
"recommendations": [
"Follow the scent of freshly baked custard tarts"
]
},
{
"name": "Monument to the Discoveries",
"neighborhood": "Belém",
"type": "Monument",
"recommendations": [
"Visit to see statues of Portugal's greatest seafarers, artists, and scientists"
]
},
{
"name": "Belém Tower",
"neighborhood": "Belém",
"type": "Tower",
"recommendations": [
"Visit this former gateway to the city"
]
}
]
},
"source": {
"provider": "youtube",
"url": "https://www.youtube.com/watch?v=utgbGMpZndw"
}
}Build the itinerary
From saved places to a day-by-day plan
Save each place with the video link, so people can rewatch why it made the list. The name and neighborhood together make a precise search for a maps or places service, which gives your app the address, opening hours and a pin on the map.
Group the places by neighborhood and you already have a plan: a morning in Baixa and Chiado, an afternoon in Alfama, a day in Belém. Save places from several videos about the same city and your app can merge them into one trip.
Build a travel app
Try the workflow in Lovable
Describe a travel app where people share a video and get its places saved to a trip. Lovable builds it with mamitsu doing the watching.
Build a travel app with Lovable
Planning from an AI client instead? Connect it to the mamitsu MCP server and ask it to plan a day from a video.
Related guides