agentres.dev

{
  "properties": {
    "available_neighborhoods": {
      "description": "Present when `neighborhood` was supplied and both exact and fuzzy matching missed — the known neighborhoods for the requested city, in place of a bare empty result.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "charge_id": {
      "format": "uuid",
      "type": "string"
    },
    "limit": {
      "type": "integer"
    },
    "neighborhood_match": {
      "description": "Present when `neighborhood` was supplied and matched: exact = matched a venue neighborhood name directly, fuzzy = matched via full-text search after an exact miss.",
      "enum": [
        "exact",
        "fuzzy"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer"
    },
    "restaurants": {
      "items": {
        "description": "Row shape depends on `fields`. DEFAULT (slim): only id, name, specials, and specials_checked_at are present. fields=full: additionally image_url, cuisine, price, website_url, cities, neighborhoods, and locations, with complete special objects.",
        "properties": {
          "cities": {
            "description": "fields=full only",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "cuisine": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "description": "Blackbird restaurant id (NOT a Resy venue_id)",
            "format": "uuid",
            "type": "string"
          },
          "image_url": {
            "description": "fields=full only",
            "type": [
              "string",
              "null"
            ]
          },
          "locations": {
            "description": "fields=full only",
            "items": {
              "additionalProperties": true,
              "properties": {
                "address": {
                  "description": "street/street2/city/state/zipcode/country",
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "latitude": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "longitude": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "neighborhood": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "region": {
                  "description": "e.g. 'New York, NY'",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "time_zone": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "name": {
            "type": "string"
          },
          "neighborhoods": {
            "description": "fields=full only",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "price": {
            "description": "Price tier, 1 (cheap) to 4 (expensive). fields=full only",
            "type": [
              "integer",
              "null"
            ]
          },
          "specials": {
            "description": "Always present, from a daily cache (never a live call). null = never checked (or the last check failed and nothing has ever succeeded); [] = checked, no current offers; non-empty = checked, with offers. By DEFAULT (slim) items are trimmed to {label, emoji?, fly_reward_bips?}; the full object shown here appears with fields=full and on the /specials detail endpoint.",
            "items": {
              "properties": {
                "check_in_threshold": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "emoji": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "fly_reward": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "fly_reward_bips": {
                  "description": "Reward rate in basis points, e.g. 1000 = 10x Fly",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "id": {
                  "format": "uuid",
                  "type": "string"
                },
                "label": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": [
              "array",
              "null"
            ]
          },
          "specials_checked_at": {
            "description": "When specials were last checked against Blackbird by the daily specials cron. null if never checked. Up to 24h stale.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "synced_at": {
            "description": "When this catalog row was last synced from Blackbird",
            "format": "date-time",
            "type": "string"
          },
          "website_url": {
            "description": "fields=full only",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "synced_at": {
      "format": "date-time",
      "type": [
        "string",
        "null"
      ]
    },
    "total": {
      "type": "integer"
    }
  },
  "type": "object"
}