HTTP API reference

{
  "items": [
    {
      "id": "prov-cafe:espresso",
      "name": "Espresso",
      "kind": "drink",
      "tags": ["coffee", "specialty-coffee"],
      "price": { "amount": 890, "currency": "HUF", "unit": "each", "source": "published" },
      "providerId": "prov-cafe",
      "providerName": "Example Café",
      "category": "Cafés",
      "borough": "Erzsébetváros",
      "neighborhood": "Gozsdu Udvar",
      "address": "1075 Budapest, Kazinczy utca 1",
      "venue": { "id": "prov-cafe", "name": "Example Café", "category": "Cafés", "...": "VenueLink" },
      "sectionTitle": "Coffee",
      "source": "venue",
      "eventTitle": null,
      "venueResolved": true
    }
  ],
  "total": 42,
  "providersWithMenu": 8,
  "tourReadiness": {
    "palinka": { "eligible": 2, "ready": false, "stopCount": 3 },
    "foodie": { "eligible": 1, "ready": false, "stopCount": 3 },
    "coffee": { "eligible": 3, "ready": true, "stopCount": 3 }
  }
}

{
  "tourId": "palinka",
  "seed": "palinka-1715000000",
  "templateId": "palinka",
  "stops": [
    {
      "providerId": "prov-cellar",
      "providerName": "Example Cellar",
      "category": "Restaurants",
      "borough": "Erzsébetváros",
      "neighborhood": "Jewish Quarter",
      "address": "1075 Budapest, ...",
      "website": "https://...",
      "image": "https://i.ibb.co/...",
      "highlightItems": [
        { "name": "House plum pálinka (4 cl)", "priceLabel": "1,490 Ft" }
      ]
    }
  ]
}

interface SiteDoc {
  _id: "main";
  logoUrl: string;
  homeHeroUrl: string;
  discoverHeroUrl: string;
  homeHeroTitle: string;
  homeHeroSubtitle: string;
  homeHeroPrimaryCta: string;
  homeHeroSecondaryCta: string;
  homeHeroTagline: string;
  homeCategoriesTitle: string;
  neighborhoodSectionTitle: string;
  /** Use "{borough}" as a placeholder for the selected borough name. */
  popularNeighborhoodsCaption: string;
  guidesSectionTitle: string;
  guidesViewAllLabel: string;
  guidesViewAllHref?: string;
  guides: SiteGuide[];
  howItWorksSectionTitle: string;
  howItWorksSteps: SiteHowStep[];
  trustPillars: SiteTrustPillar[];
  trustLines: string[];
  popularPicksSectionTitle: string;
  popularPicksViewAllLabel: string;
  newsletterTitle: string;
  newsletterSubtitle: string;
  newsletterPlaceholder: string;
  newsletterCta: string;
  newsletterFinePrint: string;
  sidebarTitle: string;
  sidebarBody: string;
  sidebarCtaLabel: string;
  homePopularPickProviderNames: string[];
  homePopularMeetupGroupId: string;
  /** Fixed HUF conversion rates for the public currency switcher (defaults 350 / 300). */
  currencyRates: { hufPerEur: number; hufPerUsd: number };
  calculator: SiteCalculatorCopy;
  account: SiteAccountSettings;
}

interface SiteCalculatorCopy {
  title: string;
  subtitle: string;
  clearAllCta: string;
  emptyTitle: string;
  emptyMessage: string;
  asideTitle: string;
  asideSubtitle: string;
  asideFootnote: string;
  providerLinePriceSuffix: string;
  estimatedTotalLabel: string;
}

/** My Account, family prefs, neighborhood preview, alerts — full shape in `src/types/site.ts`. */
interface SiteAccountSettings {
  page: { title: string; subtitle: string };
  navTabs: { id: string; label: string }[];
  saved: { tabId: string; title: string; filterChips: { label: string; categoryFilter: string }[]; /* … */ };
  activityPlan: { tabId: string; title: string; priceUnits: { class: string; week: string; party: string; visit: string }; /* … */ };
  familyPreferences: { tabId: string; sections: { id: string; label: string; options: string[]; defaultSelected: string[] }[]; /* … */ };
  neighborhood: { tabId: string; title: string; nearbyNeighborhoods: string[]; /* … */ };
  alerts: { tabId: string; options: string[]; frequencyChoices: string[]; /* … */ };
  privacy: { headline: string; supportEmail: string; /* … */ };
}

type SiteTone = "orange" | "teal" | "pink" | "amber" | "blue";
type SiteIconKey =
  | "map-pin" | "list-checks" | "heart" | "shield-check" | "compass" | "users" | "calculator";

interface SiteGuide {
  id?: string;
  title: string;
  desc: string;
  borough: Borough;
  neighborhood: string;
  imageUrl: string;
  tone: SiteTone;
  ctaLabel?: string;
  ctaHref?: string;
}

interface SiteHowStep {
  step: number;
  title: string;
  desc: string;
  tone: SiteTone;
  icon: SiteIconKey;
}

interface SiteTrustPillar {
  title: string;
  desc: string;
  tone: SiteTone;
  icon: SiteIconKey;
}

{
  "operations": [
    { "resource": "providers", "action": "list" },
    { "resource": "provider", "action": "get", "id": "my-studio" },
    { "resource": "site", "action": "get" },
    { "resource": "locations", "action": "list" },
    {
      "resource": "provider",
      "action": "upsert",
      "document": { "id": "my-studio", "...": "full Provider fields" }
    },
    {
      "resource": "providers",
      "action": "replaceAll",
      "documents": [{ "id": "a", "name": "..." }]
    },
    { "resource": "providers", "action": "deleteMany", "ids": ["legacy-1", "legacy-2"] },
    {
      "resource": "site",
      "action": "put",
      "document": { "logoUrl": "https://...", "...": "full SiteDoc fields" }
    },
    {
      "resource": "locations",
      "action": "replace",
      "locations": [
        { "borough": "Belváros", "neighborhoods": ["Inner City", "Jewish Quarter"] }
      ]
    },
    { "resource": "events", "action": "list" },
    {
      "resource": "event",
      "action": "upsert",
      "document": {
        "id": "event-example-2026",
        "venueIds": ["prov-host-arena"],
        "startsAt": "2026-08-01T20:00:00+02:00",
        "...": "NightEvent fields — upsert host venue first"
      }
    },
    {
      "resource": "provider",
      "action": "patch",
      "id": "prov-cafe",
      "patch": {
        "menu": {
          "menuUrl": "https://cafe.hu/menu",
          "sourceUrls": ["https://cafe.hu/menu"],
          "lastVerifiedAt": "2026-05-16",
          "sections": [{ "id": "drinks", "title": "Drinks", "kind": "drink", "items": [] }]
        }
      }
    }
  ]
}

{
  "resource": "provider",
  "action": "upsert",
  "document": { "id": "solo-provider", "name": "Example", "...": "remaining Provider fields" }
}

{
  "ok": true,
  "results": [
    { "index": 0, "ok": true, "data": [ { "id": "...", "name": "..." } ] },
    { "index": 1, "ok": true, "data": { "id": "my-studio", "name": "..." } },
    { "index": 2, "ok": false, "error": "provider not found" }
  ]
}

curl -sS -X POST "https://budapest-night.vercel.app/api/ingest" \
  -H "Authorization: Bearer $INGEST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resource":"provider","action":"patch","id":"my-id","patch":{"rating":5}}'