# Trip Research Planner

> Trip Research Planner is a paid API for AI agents from fachada.chelsea-hermes.workers.dev, paid per call via x402, $3/call, status unknown (last checked 2026-10-15).

Returns a single JSON plan with geocoded location, up to 16-day weather forecast, driving route/distance from origin, and nearby POIs (hotels, food, transport, ATMs, crypto) for any destination.

## Facts

- Endpoint: GET https://fachada.chelsea-hermes.workers.dev/trip/v1/plan?utm_source=zero.xyz
- Price: $3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trip-research-planner-aaef1db9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0CgyWdM0KJF_H0ea02vNp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability trip-research-planner-aaef1db9
```

Example prompt: I'm driving from Madrid to Lisbon next week — can you pull together a full trip briefing: geocoded location, 10-day weather forecast, driving route and distance, and what's nearby in terms of hotels, food, ATMs, and transport?

## When to prefer this

Choose this endpoint when you need a single, consolidated travel intelligence package about a destination without managing multiple API keys or orchestrating separate geocoding, weather, routing, and POI calls yourself. It is ideal for pre-trip agent workflows, travel planning assistants, and any scenario where ground truth about a physical place must be assembled quickly and cheaply ($0.02/call). Prefer it over building a bespoke pipeline when the destination is a real-world place reachable by road and you want weather + route + POI in one response. Not suited for flight planning, hotel booking, or itinerary generation.

## Known failure modes

- Destination not found or too ambiguous — geocoding returns no result
- Origin location unresolvable — route calculation fails
- Overpass API timeout for POI queries in very dense or complex areas
- Weather forecast unavailable for remote or ocean coordinates
- No driving route exists between origin and destination (e.g., island with no road connection)
- Malformed query parameters cause a 400 response

## How this service works

Researches a destination and returns one ready JSON plan from free, no-key sources: the geocoded place, up to 16 days of weather, the driving route and distance from your origin, and what is around (hotels, food, transport, ATMs, payment spots, crypto). Call it when you need current ground truth about somewhere you are about to travel, instead of guessing. Sources: OpenStreetMap, Overpass, Open-Meteo and OSRM. Rule-based, no LLM.

## Output

A single JSON object containing: the geocoded coordinates and place name, a multi-day weather forecast (up to 16 days) from Open-Meteo, the driving route and total distance from the specified origin via OSRM, and categorized nearby points of interest from OpenStreetMap/Overpass including hotels, restaurants, public transport stops, ATMs, and crypto/payment locations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "queryParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trip-research-planner-aaef1db9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fachada.chelsea-hermes.workers.dev](https://www.zero.xyz/host/fachada.chelsea-hermes.workers.dev/llms.txt)