Skip to main content
Blue Pillow Hotels and Stays logo
  • Category: ai agents
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 8
  • Triggers: 0
  • Slug: BLUEPILLOW
  • Version: 00000000_00

Tools

Slug: BLUEPILLOW_CREATE_BOOKING_HANDOFFCreate only a tracked Blue Pillow handoff link for the user to continue the booking process. This does not reserve a room, confirm a reservation, or collect payment.

Input Parameters

string
Preferred OTA from a current offer. Omit it to let Blue Pillow choose the best price.
object
required
Stay dates to embed in the handoff link.
object
required
Room occupancy to embed in the handoff link.
string
required
Blue Pillow property ID the user chose.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLUEPILLOW_DISCOVER_DESTINATIONS_NEARFind cities, neighborhoods, airports, or points of interest near geographic coordinates.

Input Parameters

string ("en" | "it" | "fr" | "de" | "es" | "pt" | "nl" | "ko" | "pl" | "ja")
Language for destination names and display labels.
number
required
Latitude from -90 to 90.
number
required
Longitude from -180 to 180.
number
Positive search radius in kilometers.
string ("city" | "neighborhood" | "airport" | "poi")
Restrict candidates to one destination type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLUEPILLOW_GET_PROPERTYGet canonical details and optional review enrichments for one property; use search or hotel recommendation for live availability.

Input Parameters

array
Review enrichments to include. reviews_extended supersedes reviews_sample; the list is sent as one comma-separated query value.
string
ISO 4217 pricing currency; defaults from user_country and then to USD.
string
Two-letter lowercase language code.
string
required
Blue Pillow property ID returned by search or recommendation, normally prefixed prop_.
string
ISO 3166 alpha-2 country for booking-link locale and default pricing currency.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLUEPILLOW_RECOMMEND_OFFER_FOR_PROPERTYCompare live OTA offers and recommend the best offer for a property the user has already selected. This endpoint has no locale or currency input, so Blue Pillow applies provider defaults; use the currency returned in the response.

Input Parameters

object
required
Stay dates; check_out must be after check_in.
object
required
Room occupancy for the stay.
string
required
Selected Blue Pillow property ID returned by search or recommendation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLUEPILLOW_RECOMMEND_STAYRank a location to one recommended stay plus alternatives. A recommendation may have no live price and unknown availability, so validate an offer before booking handoff.

Input Parameters

object
required
Stay dates; check_out must be after check_in.
object
required
Room occupancy for the stay.
object
Optional locale and agent context. When supplied, end_user_country and currency are both required.
object
required
Recommendation location. Destination IDs can come from Resolve Destination.
object
Optional price, rating, property, amenity, cancellation, and OTA constraints.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLUEPILLOW_RESOLVE_DESTINATIONResolve a place name into destination IDs for stay search, including ambiguity and confidence information.

Input Parameters

string
required
Place name to resolve, such as a city, neighborhood, airport, or point of interest.
string
Optional country bias used to disambiguate the place name.
string ("en" | "it" | "fr" | "de" | "es" | "pt" | "nl" | "ko" | "pl" | "ja")
Language for destination names and display labels.
string ("city" | "neighborhood" | "airport" | "poi")
Restrict candidates to a city, neighborhood, airport, or point of interest.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLUEPILLOW_SEARCH_STAYSSearch one page of ranked live stay inventory with availability, prices, OTA offers, and an opaque cursor for more results.

Input Parameters

string ("score_desc" | "price_asc" | "rating_desc" | "conversion_desc")
Ranking order for results.
object
Stay dates, required for an initial search and omitted for a cursor-only continuation; check_out must be after check_in.
integer
Maximum results in this page, from 1 to 100.
object
Room occupancy, required for an initial search and omitted for a cursor-only continuation.
object
Optional result filters.
string
Uppercase ISO 4217 currency for returned prices.
string
Two-letter lowercase response language code.
object
Search location, required for an initial search and omitted for a cursor-only continuation. Prefer a destination_id returned by Resolve Destination.
string
Opaque cursor returned by a previous call. It restores the original search criteria, so continuation may provide this field alone.
string
Uppercase ISO 3166 alpha-2 country for locale and default currency.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLUEPILLOW_VALIDATE_OFFERRe-price a previously seen EUR offer and report whether it remains valid within the provider’s two-percent tolerance.

Input Parameters

object
required
Exact stay dates associated with the observed offer.
object
required
Exact room occupancy associated with the observed offer.
string
required
Blue Pillow property ID for the observed offer.
object
required
Previously observed offer expressed in EUR. A numeric amount from another currency must be converted to EUR before comparison.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not