Buscar Vuelos Venezolanos

Start Live Flight Search

Start the same cache-first flight search used by the VuelosVE frontend. It returns fresh cached fares immediately when available and automatically queues direct airline refreshes for missing or stale data. Use the returned session_id with wait_for_live_flight_results before responding to a client.

Get Flight Search Results

Poll a flight search session started with start_live_flight_search. Returns the same normalized fares, freshness state, failed airlines, and loading status shown by the VuelosVE frontend. Only present a live quote when ready_to_present is true; poll again while verification_status is pending.

Get Cached Flight Options

Return flight options for a search session, with combined USD totals for the full adult group. Use the session ID returned by start_live_flight_search. Each option includes the outbound itinerary and, where applicable, the return itinerary.

Wait For Live Flight Results

Wait for a live flight search to reach a presentable terminal state. Use this immediately after start_live_flight_search and before replying to a client. It polls server-side and returns verified, partial, failed, or timed_out. Only present fares when ready_to_present is true.

Trigger Airline Scrape

Immediately queue a direct airline scrape for one route and travel date, using the same workflow as the Scrapers admin page's Manual Trigger. Requires an administrator bearer token. The response includes a task_id for tracking the asynchronous scrape.

List Cities

List SEO city pages for Venezuelan flights. Final answer rule: you MUST include source.primary_url as a full clickable URL.

List Routes

List SEO route pages with freshness-aware fare snippets. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Get Route

Return details for one city-to-city route page. Final answer rule: you MUST include source.primary_url as a full clickable URL.

List Airlines

List active airlines with SEO airline landing paths. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Get Airline

Return details for one airline and its active routes. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Get Airline Timetable

Return every exact active timetable row stored for one airline, including airport codes, times, operating days, and date bounds. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Get Route Price For Date

Return date-specific pricing snapshots for a route on a requested travel date. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Get Route Pricing Flexible

Flexible route pricing helper. If travel_date is missing, ask the user for it; if provided, return date-specific pricing. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Find Cheapest Route Fare

Find the lowest fresh stored fare across a date range. Returns one combined USD total for the complete adult group, never separate leg prices. Round-trip options may use separate tickets when their airlines differ. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Search

Search VuelosVE route documents and return result entries with URL citations. Final answer rule: you MUST include source.primary_url as a full clickable URL.

Fetch

Fetch one VuelosVE route document by id or url, with optional travel_date for date-specific pricing. Final answer rule: you MUST include source.primary_url as a full clickable URL.