TableJourney food travel

Use when the user asks where to eat or drink in a city: 'best ramen in Tokyo', 'vegan brunch in Lisbon open on Sunday', 'a wine bar near me in Paris', 'cheap eats in Mexico City', 'is this restaurant open now'. Search verified venues (read-only). Filter by text, city, kind (a topic such as restaurants, cafes, bakeries, markets, street-food, or a group: eat, drink, bake, do), cuisine, dietary, price tier, opening time, or near a coordinate. Results are ranked by relevance then editorial score and carry provenance (source URL, checked_on, open_status), hours, a page URL to cite and a tracked booking link where one exists. Returns at most `limit` items; an unknown city returns {did_you_mean: [...]} instead of a list.

Use when the user wants a day planned: 'plan a food day in Paris on Saturday', 'where should I have breakfast, lunch and dinner in Seville'. Compose a food day for one city (read-only): one best-scored open venue per slot from morning to evening, filtered by neighbourhood, dietary need and price tier, every stop open on the given date, plus one bookable experience. Also lists the titles of the editorial itineraries for the city, which are the better plan when one exists (fetch them with `itineraries`).

One venue in full by id (read-only): every field, provenance, hours, open_now_utc, the booking link and three nearby venues. Returns {error: ...} when the id is malformed or unknown.

Use when the user asks what food festivals, food events or Christmas markets are on, or when one is: 'food festivals in Italy in October', 'what is on in Austin the week of November 5', 'Christmas markets in Germany', 'when is the Alba truffle fair'. Food festivals with their next resolved dates (read-only). Filter by city, country, a date window and text. Each item carries starts_on/ends_on for the next edition, the organiser source URL and the page to cite.

Use for food tours, cooking classes, tastings and market tours in a city: 'a street food tour in Bangkok', 'pasta-making class in Rome', 'wine tasting near Florence'. Bookable food tours, cooking classes, tastings and tickets for a city. Read-only. Each item has price, rating, review count, duration and a tracked `book` link. Ranked by relevance to `query` when given, otherwise by popularity.

Use for 'where to stay in <city>' or 'hotels in <city>'. Hotels and stay partners for a city (read-only): hotel listings with a tracked booking link each, plus the partner search links that cover the city. Prices are not returned; the partner page has them.

Car hire partners that verifiably cover a city (read-only): one entry per partner with the pickup facts we checked and a tracked booking link. Empty list when no partner covers the city.

Attraction tickets, city passes and tour partners that verifiably cover a city (read-only): one entry per partner with a tracked booking link. Complements `experiences`. Empty list when none covers the city.

Use when the user is planning a trip or asks what to do in a city: 'I am going to Rome next week, what should I do?', 'things to do in Bangkok for food lovers'. START HERE for 'what can I do in <city>?' (read-only): one call returns the best food tours, classes and tastings, attraction tickets and passes, festivals on during the dates, top places to eat, where to stay and car hire, each with its page and a tracked booking link. Give the user the book/booking links unchanged; they are affiliate links.

Use when the user asks what to eat somewhere or where to find a dish: 'what should I eat in Naples?', 'where to get pastel de nata in Lisbon', 'local dishes in Hanoi'. Signature dishes of a city and where to eat them (read-only). Each item has a description, the venues resolved to ids and page URLs, and the page to cite; ranked by editorial score.

Use for 'a two-day food itinerary for <city>' or 'how to spend 48 hours eating in <city>'. Editorial day-by-day food itineraries for a city (read-only): every venue resolved to an id, address, hours and page URL. Empty list when the city has none.

Every city the site covers (read-only), with the country and city slugs the other tools accept and the hub page URL. Call first when unsure of coverage.

Create a free partner account so you earn a share of the commission on bookings made by people you send to TableJourney (see partner terms at /partners/terms/). No inbox? Leave email out: the answer holds your API key and referral code at once (add an email with partner_add_email before your first payout). With an email we send a one-time code; pass it to partner_confirm. accept_terms must be true. The person or company running the agent is the member and the payee.

Confirm the email address with the code from partner_join. Returns your API key (shown once: send it as `Authorization: Bearer <key>` or X-API-Key; every booking link this server returns to it carries your code) and your referral code (add ?ref=<code> to any tablejourney.com link).

Needs your API key or OAuth token. For an account that joined without an email: we send a code to the address; confirm it with partner_confirm (your API key stays the same). Needed before your first payout and to recover the account if the key is lost.

Email a one-time sign-in code to a partner account (for a new API key with partner_signin).

Exchange the emailed sign-in code for a new API key (the old key stops working).

Needs your API key or OAuth token. Any page of the site, with your ?ref= code added.

Needs your API key or OAuth token. Visits and partner clicks your links brought, and earnings by status (pending until the partner pays us, then payable after the hold).

Needs your API key or OAuth token. type is paypal (paypal_email); a crypto wallet with address: usdc_base (USDC on Base), usdc_solana (USDC on Solana), eth (ETH on Ethereum), sol (SOL on Solana) or btc (Bitcoin), so an agent can be paid to its own wallet with no bank account; or bank (holder, country, currency, iban or account_number, bic or routing_number). We email a code; the details take effect only after partner_confirm_payout.

Needs your API key or OAuth token. The code from the payout email.