A purchasable offer — typically a flight itinerary with a price.
An offer wraps one or more flights into a bookable unit.
| Metadata | Value |
|---|
| Plural | offers |
| Field | Type |
|---|
price | number |
currency | string |
offerType | string |
availability | string |
validFrom | datetime |
validUntil | datetime |
bookingToken | string |
External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.
- schema.org/Offer — Our price = price; currency = priceCurrency; availability = availability; validFrom/validUntil match directly.
- IATA NDC OfferItem — Our bookingToken ≈ OfferItemID; validUntil ≈ TimeLimits/ OfferExpirationDateTime; trips[] ≈ Itinerary.
- schema.org/AggregateOffer — For price-range offers (SerpAPI flight results). offerType is AgentOS-specific.
- serpapi —
search_offers, list_offers, get_offer