Smiles Mileage & Redemption Data API · Live

Pull live Smiles data
in the time it takes
to read this sentence.

Flight availability, mileage cost, partner catalog pricing, and tier-based bonuses across Brazil's largest coalition loyalty program — structured and delivered as clean JSON or CSV. No proxies to manage, no CAPTCHAs to solve, no HTML to parse.

See a Live Response
100K+ Routes Tracked
8M+ Mileage Checks
4 Categories Covered
Real-Time Data Refresh
GET /v1/smiles/flight-availability
LIVE
// request timestamp 2026-07-21 04:31:10 UTC { "route_id": "SM-GIGREC", "origin": "GIG", "destination": "REC", "carrier": "GOL", "cabin": "Economy", "miles_required": 18000, "cash_taxes": { "amount": 142.30, "currency": "BRL" }, "seats_left": 2, "availability": "available", "fetched_in_ms": 1738 }
TRUSTED BY CLIENTS ACROSS MULTIPLE INDUSTRIES
Travel Tech Loyalty Program Aviation Analytics Market Research Logistics Technology
500+
GLOBAL CLIENTS SERVED
300+
PROJECTS DELIVERED
50M+
MONTHLY API CALLS
24/7
DEDICATED SUPPORT
Why Choose Our Smiles API

Prices in miles, not just Reais — and mileage cost moves independently of cash fare.

Smiles is a coalition loyalty marketplace where flights and partner products are priced in miles that fluctuate by route, date, and tier, often independently of the underlying cash fare. Our infrastructure resolves mileage cost, taxes, and tier bonuses as first-class data, not an afterthought.

01

Zero blocking, zero maintenance

We run rotating residential IPs, headless rendering, and CAPTCHA-solving behind every request. When Smiles changes its layout, we patch our parsers — your integration never breaks.

02

Mileage cost resolved separately from cash

Every flight response separates the miles required from the cash taxes and fees still due at checkout.

03

Partner network mapping

We resolve redemption catalog items across Smiles' accumulation and redemption partner network, not just flights.

04

Built for scale from day one

From a 100-route test batch to full network-wide mileage monitoring, the same endpoint scales with you.

Smiles API Features

Everything you need to keep Smiles data flowing.

Real-time Extraction

Trigger an on-demand pull for any route or redemption item and get a fresh response — not a stale cache.

🧩

Custom Field Selection

Request only the fields you need — mileage cost, taxes, tier bonus — to cut payload size and parsing time.

✈️

Flight Availability by Miles

Pull seat availability and mileage cost by cabin class across the Smiles flight network.

🎯

Tier-based Bonus Resolution

Resolve mileage bonuses and discounts that vary by Diamond, Gold, Silver, and base tier status.

📦

Bulk & Scheduled Requests

Submit thousands of route or product IDs in one batch job or schedule recurring pulls on a custom cadence.

📊

Historical Mileage Tracking

Store and query mileage cost history per route to power fare-alert and repricing tools.

What Data Can You Access?

Every field a redemption page shows — mileage cost and tier bonuses included.

CoreRoute / product IDOrigin-destination pair or catalog SKU
PricingMileage costMiles required by cabin class
PricingCash taxes & feesRemaining cash due at checkout
BlendedMiles + cash comboPartial-miles payment option and rate
AvailabilitySeat availabilityAward seats remaining by cabin
LoyaltyTier bonusDiscount by Diamond, Gold, Silver status
NetworkPartner catalogRedeemable products across partner network
PromosBonus mile campaignsActive accumulation bonus offers
AirlinesOperating carrierGOL and partner airline flights
ReviewsRatings & review countWhere available on partner catalog items
ScheduleFlight scheduleDeparture/arrival times, stops, duration
StructureCategory breadcrumbsFlights, hotels, retail, dining categories
Supported Smiles Categories

Flights, hotels, retail, and dining — one redemption network.

Switch the category parameter to pull from a different part of the Smiles redemption catalog with the same consistent response shape.

✈️

Flights

GOL and partner airline routes redeemable by miles.

🏨

Hotels

Partner hotel bookings redeemable via the Smiles catalog.

🛍️

Retail

Products redeemable from partner retail stores.

🍽️

Dining

Restaurant partner offers and mile-earning promotions.

Brazil-wide

Coverage across GOL's domestic and partner network

Tier-aware

Pricing resolved per Diamond/Gold/Silver status

Real-time

Mileage cost and availability checked on every request

Smiles API Endpoints

A small set of endpoints that cover the whole redemption lifecycle.

Method Endpoint Description Typical use
GET /v1/smiles/flight-availability Mileage cost & seat availability by route and date Fare-alert & mileage monitoring
GET /v1/smiles/search Route or catalog keyword search results Market & competitor discovery
GET /v1/smiles/redemption Full redemption item detail by ID Catalog & pricing intelligence
GET /v1/smiles/reviews Paginated reviews for partner catalog items Sentiment analysis
GET /v1/smiles/offers Active bonus mile campaigns & promotions Promo & accumulation intelligence
GET /v1/smiles/tier-pricing Mileage cost by Diamond/Gold/Silver tier Loyalty tier analysis
POST /v1/smiles/bulk Submit up to 10,000 routes or items per batch job Network-wide monitoring
Live API Response Example

This is exactly what comes back. No extra parsing needed.


        
Popular Smiles API Use Cases

Built for the teams that live and die by Smiles data.

📈

Mileage Cost Monitoring

Track how miles-required-per-route shifts by date, season, and demand.

🔍

Award Availability Research

Analyze seat availability trends by cabin class and route to time redemptions.

🛡️

Tier Value Analysis

Compare mileage pricing across loyalty tiers to quantify status upgrade value.

💬

Partner Catalog Sentiment

Pull reviews on partner redemption items to track satisfaction trends.

🎯

Bonus Campaign Tracking

Monitor active bonus-mile promotions across accumulation partners.

📦

Loyalty Program Comparison Tools

Build side-by-side comparisons of mileage value across coalition programs.

🏆

Route Profitability Benchmarking

Compare award redemption value against cash fare for the same route.

🧭

ML Training Data

Generate labeled route, mileage, and availability datasets for pricing models.

How the Smiles API Works

From API key to structured data in five steps.

1

Get your API key

Sign up and generate a key from your dashboard in under two minutes.

2

Choose an endpoint

Pick /flight-availability, /redemption, /search or /tier-pricing depending on what you need.

3

Send the request

Call the endpoint with a route, product ID, or keyword and your travel dates.

4

We handle the hard part

Proxies, headless rendering, CAPTCHA-solving, and parsing all happen behind the scenes.

5

Receive structured data

Get clean JSON or CSV back in seconds, ready to drop into your pipeline.

Developer-Friendly Integration

Built by people who read the docs too.

One consistent JSON schema across every endpoint. No SDK lock-in — plain REST calls work from any language or platform.

Predictable REST design

Standard HTTP verbs, query params, and status codes — nothing proprietary to learn.

JSON, CSV, or webhook delivery

Get results inline, as a downloadable file, or pushed to your endpoint when a batch job finishes.

Sandbox & test keys

Free sandbox environment with sample routes and product IDs so you can build before you pay.

Postman collection & SDK snippets

Import a ready-made collection or copy request snippets for Python, Node.js, and cURL.

Quickstart
API Performance & Reliability

Numbers we publish because we track them daily.

99.9%
Uptime SLA
<3s
Avg. response time
99.3%
Successful extraction rate
10K+
Concurrent requests supported
Security & Compliance

Compliant by design, not as an afterthought.

🔒

Encrypted in transit

All requests and responses travel over TLS 1.2+. API keys can be scoped and rotated anytime.

⚖️

LGPD & global alignment

Our extraction workflows are built around Brazil's LGPD alongside GDPR and CCPA guidelines.

🌐

Public-data-only policy

We collect only publicly accessible listing data — never login-gated or private account information.

ISO 9001:2015 Certified ISO/IEC 27001:2013 Certified IAF Multilateral Recognition GDPR-aligned workflows
API Documentation & Resources

Everything to go from key to production.

Guide

Quickstart Guide

Get your first API response back in under five minutes.

Read guide →
Reference

Full API Reference

Every endpoint, parameter, and response field documented in detail.

View reference →
Tool

Postman Collection

Import ready-made requests for every Smiles API endpoint.

Download →
Code

SDKs & Code Samples

Python, Node.js, PHP, and Ruby snippets for every use case.

Browse samples →
Frequently Asked Questions

Still deciding? Here's what most teams ask first.

We collect only publicly accessible flight and redemption catalog data using automated tools, following publicly available web-data guidelines. We recommend reviewing your own use case with legal counsel, especially for redistribution.

Every request to /flight-availability, /redemption, and /tier-pricing triggers a live pull — you're not reading from a stale cache. Bulk jobs complete within minutes depending on batch size.

Yes. The /flight-availability endpoint returns miles required and remaining cash taxes/fees as separate fields, matching what's shown at checkout.

Yes — the /tier-pricing endpoint returns mileage cost for Diamond, Gold, Silver, and base tier status where that pricing differs.

Our infrastructure retries automatically across a rotating proxy pool. You're only billed for successfully returned responses.

Yes, every account starts with a free sandbox key and sample credits so you can test all endpoints before committing to a plan.

Brand Image
INQUIRE NOW