Free APImobile.free.fr ↗
Access Free Mobile's phone catalog, forfait plans, and AXA insurance details via 3 structured JSON endpoints. Prices, specs, and coverage in one API.
What is the Free API?
The Free Mobile API exposes 3 endpoints covering the complete phone catalog, all available forfait plans, and insurance terms offered on mobile.free.fr. The get_phones endpoint returns per-device fields including brand, connectivity flags (4G, 5G, 5G+, eSIM), color and storage options, and pricing. The get_plans endpoint breaks down each plan's data allowance, voice/SMS/MMS limits, price in cents, and Freebox subscriber discounts. All responses include a total_count field.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/cfd40184-2473-4fb2-82da-b616deb62cfc/get_phones' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace mobile-free-fr-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.free_mobile_api import FreeMobile, Phone, Plan, InsuranceInfo, PhoneSummary
client = FreeMobile()
# List all available phones
for phone in client.phones.list():
print(phone.brand, phone.name, phone.is_5g, phone.available)
for color in phone.colors:
print(" Color:", color.color_name, color.color_code)
for offer in phone.offers:
print(" Offer:", offer.type, offer.amount, offer.start_date)
# List all plans
for plan in client.plans.list():
print(plan.name, plan.price, plan.has_5g, plan.national_data_fairuse)
for discount in plan.discounts:
print(" Discount:", discount.applied_to, discount.type, discount.amount)
# Get insurance information
insurance = client.insuranceinfos.get()
for tier in insurance.pricing_by_class:
print(tier.class_num, tier.price_per_month)
for faq in insurance.faq:
print(faq.question, faq.answer)
for eligible in insurance.eligible_phones_sample:
print(eligible.id, eligible.brand, eligible.name)
Retrieve the full catalog of mobile phones available for purchase from Free Mobile. Each phone includes brand, model name, connectivity flags (4G/5G/eSIM), device type (foldable, refurbished, new, pack, AI-enabled), available colors and storage options, current promotional offers, energy class rating, pricing for both cash purchase and Free Flex installment plans across subscriber profiles, and real-time stock availability. The catalog is unpaginated — one request returns the complete inventory.
No input parameters required.
{
"type": "object",
"fields": {
"phones": "array of phone objects with full specifications, pricing, and availability",
"total_count": "integer total number of phones in the catalog"
},
"sample": {
"data": {
"phones": [
{
"id": 602,
"name": "Galaxy S26",
"path": "/shop/products/samsung/galaxy-s26",
"brand": "Samsung",
"is_4g": true,
"is_5g": true,
"colors": [
{
"colorBase": "Blanc",
"colorCode": "#F3F4F5",
"colorName": "Blanc"
}
],
"is_new": false,
"offers": [
{
"id": 868,
"type": "bonus_reprise_operateur",
"label": "868 - bonus_reprise_operateur",
"title": null,
"amount": 200,
"endDate": "2026-06-23",
"document": "https://mobile.free.fr/webpublic/odr_69fb47bbe8.pdf",
"startDate": "2026-05-28"
}
],
"prices": {
"cash_profile_1": {
"shop": 1,
"price": 999,
"offers": [
868,
10319
],
"discount_end_date": null,
"immediate_discount": null
},
"flex_profile_1": {
"shop": 1,
"offers": [
868,
10319
],
"buying_option": 100,
"first_payment": 299,
"monthly_price": 24.99
}
},
"is_esim": true,
"is_pack": false,
"with_ai": true,
"storages": [
256,
512
],
"available": true,
"image_url": "https://mobile.free.fr/webpublic/Master_Phone_Samsung_12_296fc48d75.png",
"is_5g_plus": true,
"is_foldable": false,
"energy_class": "A",
"is_highlight": false,
"is_recommended": false,
"is_refurbished": false,
"available_stores": [
2723,
2724,
2725
],
"energy_label_url": "https://mobile.free.fr/webpublic/Etiquette_fiche_Galaxy_S26_pdf_c5695bfcb9.pdf"
}
],
"total_count": 84
},
"status": "success"
}
}About the Free API
Phone Catalog
get_phones returns an array of phone objects, each carrying an id, brand, name, path, and image_url, alongside boolean connectivity flags: is_4g, is_5g, is_5g_plus, and is_esim. The response also includes storage options, available colors, cash prices, Free Flex installment prices, current promotional offers, and per-device availability status. A total_count integer at the root tells you how many devices are in the catalog without counting array items manually.
Mobile Plans
get_plans surfaces every forfait currently on offer, including plan name, description, price (expressed in cents for precision), type, and channel. Each plan object flags whether it includes 5G (has_5g), carries an exclusivity restriction (is_exclusivity), and lists voice, SMS, and MMS allowances. Freebox subscriber discount details are included where applicable, making it straightforward to compare standard vs. bundled pricing.
Insurance Information
get_insurance_info returns the full AXA-backed insurance product as structured data rather than a PDF. The response includes a pricing_by_class array with 8 tiers ranging from class 1 (4,99 €/mois) to class 8 (22,99 €/mois), coverage_details sections (integral coverage, repair or replace, immediate coverage), an additional_info object capturing the partner name, money-back guarantee period, engagement duration, and boolean flags for deductible and waiting period, plus an eligible_phones_sample array and a faq array of question/answer pairs.
The Free API is a managed, monitored endpoint for mobile.free.fr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mobile.free.fr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official mobile.free.fr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price comparison tool that tracks Free Mobile forfait prices and Freebox bundle discounts over time using
get_plans. - Populate a device finder app with 5G and eSIM availability from the
is_5g,is_5g_plus, andis_esimflags inget_phones. - Automate insurance cost estimation by mapping phones to their AXA tier using
pricing_by_classandeligible_phones_samplefromget_insurance_info. - Monitor promotional offers on specific phone models by polling the
get_phonesendpoint and diffing the offers field. - Display a structured FAQ and coverage summary for Free Mobile insurance in a customer-facing support tool using the
faqandcoverage_detailsfields. - Audit the Free Mobile catalog for Free Flex installment pricing vs. outright cash pricing across all brands returned by
get_phones. - Filter available plans by 5G support using the
has_5gboolean inget_plansto surface only next-generation options.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Free Mobile provide an official developer API?+
What does `get_plans` return for plan pricing, and does it include taxes?+
get_plans returns a price field expressed in integer cents (for example, 999 represents 9,99 €). The response does not include a separate tax breakdown field; the price reflects what is displayed on the Free Mobile site. Freebox subscriber discount pricing is included as a separate value on applicable plan objects.Does the API return individual phone specs like screen size, battery, or processor?+
get_phones covers connectivity flags (4G, 5G, 5G+, eSIM), storage options, colors, prices, and availability, but does not include granular hardware specs such as screen size, battery capacity, or processor model. You can fork this API on Parse and revise it to add an endpoint targeting those specification fields.Can I look up insurance pricing for a specific phone by model name?+
get_insurance_info returns an eligible_phones_sample array with id, brand, name, and path fields, and a pricing_by_class array with 8 tiers. Matching a specific phone to its insurance class requires cross-referencing those two arrays; there is no single endpoint that resolves a phone ID directly to a monthly insurance price. You can fork the API on Parse and revise it to add that lookup endpoint.Does the API cover used or refurbished phones listed on Free Mobile?+
get_phones endpoint covers new devices available for purchase with a Free Mobile forfait. Used or refurbished listings are not included in the current response. You can fork this API on Parse and revise it to add coverage of that segment if it becomes available on the site.