mobile.free.fr 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.
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'
Get all mobile phones available for purchase with a forfait from Free Mobile. Returns detailed information including model names, specifications, prices (cash and Free Flex), colors, storage options, availability, and current promotional offers.
No input parameters required.
{
"type": "object",
"fields": {
"phones": "array of phone objects with id, brand, name, path, image_url, connectivity flags (is_4g, is_5g, is_5g_plus, is_esim), device type flags (is_foldable, is_refurbished, is_new, is_pack, with_ai), colors, storages, offers, energy_class, prices (cash and flex profiles), availability",
"total_count": "integer total number of phones returned"
},
"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": 857,
"type": "bonus_reprise_operateur",
"amount": 200,
"endDate": "2026-05-27",
"startDate": "2026-05-07"
}
],
"prices": {
"cash_profile_1": {
"shop": 1,
"price": 999,
"offers": [
857,
10287
],
"discount_end_date": null,
"immediate_discount": null
},
"flex_profile_1": {
"shop": 1,
"offers": [
857,
10287
],
"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": 83
},
"status": "success"
}
}About the mobile.free.fr 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.
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.
- 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 | 250 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.