Skip to content
Tripcreator AI

Plan trips from your own code

One call returns a day-by-day trip in the same format our planner and chat read. Every MarcoPolo stop is a real place with a catalogue ID and coordinates. The sandbox is free, and we review every account before it opens.
Create a developer accountSee the benchmark
POST/v1/developer/trips
Example

Request

curl https://api.tripcreator.ai/v1/developer/trips \
  -H "Authorization: Bearer $TRIPCREATOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "marcopolo",
    "prompt": "A week in Italy, north to south, art and coast.",
    "country": "Italy",
    "days": 7
  }'

Response

200 OK

{
  "id": "trp_7Hq2",
  "model": "marcopolo",
  "environment": "sandbox",
  "trip": {
    "title": "Art and Coast Across Italy",
    "segments": [
      {
        "location": {
          "city": "Florence",
          "country": "Italy"
        },
        "days": [
          {
            "day_number": 1,
            "day_title": "Florentine Markets and Historic Stalls",
            "activities": [
              {
                "sequence": 1,
                "name": "Florence Central Market",
                "entity_id": "3458396",
                "latitude": 43.7773,
                "longitude": 11.2538
              },
              {
                "sequence": 2,
                "name": "Mercato del Porcellino",
                "entity_id": "3463217",
                "latitude": 43.77,
                "longitude": 11.2543
              },
              …
            ]
          },
          …
        ]
      }
    ]
  }
}
Example call. The places, IDs and coordinates are a real MarcoPolo answer, cut short. The id is a placeholder.

Tested against three general AI models

The same 8 trip briefs, planned by MarcoPolo and by GPT-6, Gemini 3.8 Flash and Claude Opus 4.8. MarcoPolo was up to 4.6x faster and 10.8x cheaper per trip day.

See the full benchmark
  • 0
    invented places in 115 stops

    The general models invented one in 701, checked by hand.

  • 114
    of 115 stops are verified places

    Each one is pinned on the map, ready for your team to quote. None of the general models' stops are.

  • 14.7 s
    to a finished plan

    Median in MarcoPolo Chat on production. The first day is on the map in about 5 seconds.

  • $0.02
    per trip day

    A general model costs $0.17 or more a day once each stop is checked.

What the API gives you

The models that plan for Atlas and MarcoPolo Chat, behind one key.

Two models, one trip format

MarcoPolo, trained from scratch on travel, plans from our catalogue of real places. MarcoPolo Navigator plans with maps, places and live data, in the voice you give it. Both return the same trip format.

Real places with IDs

Every MarcoPolo stop carries a catalogue ID and coordinates you can match to your own inventory.

Your catalogue or ours

Ask for your organisation catalogue and trips plan with your hotels, restaurants and experiences, with a report of your prices and markups.

A free sandbox

Sandbox keys call the same models for free, at 10 requests a minute and 25 trips a day.

Playground, logs and usage

Try a brief in the playground, then follow every call in the request log and your usage.

Signed webhooks

Webhook deliveries are signed, logged and retried when they fail.
A mountain road winding through the Dolomites under a night sky

From sign-up to your first trip

  1. 1

    Sign up

    Choose developer at sign-up. We review every account before it opens.
  2. 2

    Make a sandbox key

    Keys come in sandbox and production, with scopes and an expiry.
  3. 3

    Call the API

    POST a brief to /v1/developer/trips. A trip takes from a few seconds to about a minute.
  4. 4

    Go live

    A production key pays per trip day from prepaid credits. MarcoPolo lists at $0.02 a day.

See the models running

The same models plan in these products. Try them before you write a line of code.

More solutions

Tour operatorsEvery enquiry arrives as a planned trip, ready to quote.Host agencies and consortiaEvery advisor's enquiries scored, and a planning site under your network's brand.Travel agentsSee tour operators' trips, build client trips from them and track every commission.Destination marketingVisitors plan the whole trip on your site, and you see what they chose.Event organisersAttendees plan the days either side of your event, with your hotels first.

Build on MarcoPolo

Create a developer accountTry MarcoPolo