Count flights matching a FlightAware search query for $0.04 per request via MPP micropayment.
What it does
This endpoint returns the count of flights matching a FlightAware-style search query. It is part of StableTravel, a pay-per-request travel API suite that wraps Amadeus GDS and FlightAware AeroAPI data behind x402/MPP micropayment protocols. No API keys, OAuth tokens, or subscriptions are required — payment via USDC on Base, Solana, or Tempo serves as authentication.
The endpoint accepts a single required query parameter `query` using FlightAware's search syntax (e.g. `-idents "UAL*"`, `-latlong "36 -104 30 -86"`, `-airline "UAL"`). It returns a JSON object with a `count` field indicating how many flights match. This is useful as a lightweight pre-check before running a full flight search (which costs $0.10), letting you verify result volume at a lower cost of $0.04 per call.
The endpoint is live and returns an MPP 402 challenge using the Tempo method on chain ID 4217. The price in the OpenAPI spec is listed as $0.04 (USD). The response schema is minimal: `{"count": <number>}`. The full OpenAPI 3.1 spec is available at `/openapi.json` and interactive docs at `/docs`. StableTravel is operated by Merit Systems.
Capabilities
Use cases
- —Pre-check how many flights match a query before running a full (more expensive) flight search
- —Monitor airline traffic volume by counting flights matching an airline ident pattern
- —Count flights within a geographic bounding box for airspace density analysis
- —Validate FlightAware query syntax by checking if any results are returned
- —Build dashboards showing real-time flight counts by airline or region
Fit
Best for
- —Agents that need a cheap pre-flight-search sanity check on result volume
- —Airspace monitoring and traffic density estimation
- —Programmatic flight data access without API key management
- —Autonomous travel agents using micropayment protocols
Not for
- —Retrieving actual flight details (use the full /flights/search endpoint instead)
- —Historical flight count statistics over long time periods
- —Users who need free or subscription-based pricing
Quick start
npx agentcash fetch "https://stabletravel.dev/api/flightaware/flights/search/count?query=-airline%20%22UAL%22"Example
Response
{
"count": 342
}Endpoint
Quality
Full OpenAPI 3.1 schema with clear response type, live MPP 402 challenge captured, explicit pricing in USD, comprehensive documentation including query syntax examples. Only minor gap is no example response in the spec itself.
Citations
- —Endpoint price is $0.04 per requesthttps://stabletravel.dev/openapi.json
- —Endpoint uses FlightAware query syntax with -idents, -latlong, -airline parametershttps://stabletravel.dev/openapi.json
- —Response schema returns a count field of type numberhttps://stabletravel.dev/openapi.json
- —Payment via USDC on Base, Solana, or Tempo; no API keys neededhttps://stabletravel.dev
- —MPP challenge is live with method tempo on chain ID 4217https://stabletravel.dev/api/flightaware/flights/search/count
- —StableTravel is operated by Merit Systemshttps://stabletravel.dev/docs