Arugula

Turns the user's request, with any context they stated (location, dates, budget, party size, preferences), into an intent and returns the offers that fit, best first, each with a tracked link to show the user (tracked_url). Matching runs in the background; when no offers are back yet, call get_offers with the intent_id in a few seconds. It never buys anything. By using Arugula you agree to arugulanet.com/terms. Privacy: arugulanet.com/privacy.

{
  "type": "object",
  "properties": {
    "brief": {
      "description": "true for a short answer: each offer's title, price, fit, how to buy and tracked link, without the explanations.",
      "type": "boolean"
    },
    "budget": {
      "description": "The user's budget.",
      "properties": {
        "amount": {
          "description": "A decimal amount, for example 25.00.",
          "type": "string"
        },
        "currency": {
          "description": "ISO 4217, for example SGD.",
          "type": "string"
        }
      },
      "required": [
        "amount",
        "currency"
      ],
      "type": "object"
    },
    "country": {
      "description": "The user's country as ISO 3166-1 alpha-2, for example SG, only if the user said it or you know it from them; never your server's. Offers there are preferred; a place in the text still decides.",
      "type": "string"
    },
    "dates": {
      "description": "When: dates or times the user gave, for example 'before 9am tomorrow'.",
      "type": "string"
    },
    "locale": {
      "description": "BCP 47 language tag of the text, for example en-SG.",
      "type": "string"
    },
    "party_size": {
      "description": "How many people.",
      "minimum": 1,
      "type": "integer"
    },
    "preferences": {
      "description": "Anything else the user prefers, in their words.",
      "type": "string"
    },
    "text": {
      "description": "What the user wants, in their own words, including where if it matters.",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

The offers ranked for an intent from find_offers, best first, only those that fit, each with its tracked link (tracked_url) and how_to_buy. offer_id is the offer's public ID: lst_ for a merchant listing (open tracked_url to book with the merchant, no sign-in), off_ for a seller's offer on Arugula. By using Arugula you agree to arugulanet.com/terms. Privacy: arugulanet.com/privacy.

{
  "type": "object",
  "properties": {
    "brief": {
      "description": "true for a short answer: each offer's title, price, fit, how to buy and tracked link, without the explanations.",
      "type": "boolean"
    },
    "intent_id": {
      "description": "The intent_id find_offers returned (int_...).",
      "type": "string"
    }
  },
  "required": [
    "intent_id"
  ],
  "additionalProperties": false
}

One match with its explanation: why the offer fits the request, its fit and verification, and the draft terms (getMatch). brief: true leaves the explanation out. By using Arugula you agree to arugulanet.com/terms. Privacy: arugulanet.com/privacy.

{
  "type": "object",
  "properties": {
    "brief": {
      "description": "true for a short answer: each offer's title, price, fit, how to buy and tracked link, without the explanations.",
      "type": "boolean"
    },
    "match_id": {
      "description": "The match's ID (mat_...).",
      "type": "string"
    }
  },
  "required": [
    "match_id"
  ],
  "additionalProperties": false
}