Lit une fiche franchise sur Franchise Direct. Passez l'URL de fiche renvoyée par la recherche. La réponse est un objet plat. Les montants vont par paire : le texte imprimé et les dollars entiers extraits.
CoffeeNow sur https://www.franchisedirect.com/coffee-franchises/coffeenow renvoie minimum_cash_required 60000 et minimum_cash_required_display $60,000, la même paire que la carte de recherche. La fiche ajoute le droit d'entrée et la fourchette d'investissement.
GET https://api.piloterr.com/v2/franchisedirect/franchise?query=https://www.franchisedirect.com/coffee-franchises/coffeenow
GET https://api.piloterr.com/v2/franchisedirect/franchise?query=https://www.franchisedirect.com/food-franchises/3-men-a-bagel/
GET et POST prennent le même query. La seconde URL est la carte 3 Men & a Bagel d'une recherche coffee. L'apport de la fiche est 250000 / $250,000, identique à la carte.
| Paramètre |
Obligatoire |
Exemple |
query |
oui |
https://www.franchisedirect.com/coffee-franchises/coffeenow |
query est obligatoire. C'est une fiche sur franchisedirect.com : au moins deux segments, hors search, directory et industries. Un chemin relatif comme /coffee-franchises/coffeenow est accepté. Un mot-clé ou une URL de liste renvoie 400.
| Champ |
Type |
Sens |
name |
string |
Nom |
url |
string |
URL de fiche sans query string |
description |
string ou null |
Résumé |
industry |
string ou null |
Catégorie du fil d'Ariane, sinon celle du chemin |
image |
string ou null |
Logo |
business_type |
string ou null |
Type, par exemple Franchise |
available_locations |
string ou null |
Zones proposées, y compris les États exclus quand la page les imprime |
financing_assistance |
string ou null |
Note de financement |
training_provided |
boolean ou null |
true ou false si la page dit oui ou non |
minimum_cash_required |
number ou null |
Apport minimum en dollars entiers |
minimum_cash_required_display |
string ou null |
Texte, par exemple $60,000 |
franchise_fee |
number ou null |
Droit d'entrée en dollars entiers |
franchise_fee_display |
string ou null |
Droit d'entrée imprimé, par exemple $25,000 |
total_investment_min |
number ou null |
Bas de la fourchette |
total_investment_max |
number ou null |
Haut de la fourchette |
total_investment_display |
string ou null |
Fourchette imprimée, par exemple $133,000 - $309,000 |
Pour CoffeeNow, le droit d'entrée est 25000 / $25,000 et l'investissement 133000 à 309000 avec $133,000 - $309,000. training_provided vaut true. Pas d'enveloppe results.
- Comparer le droit d'entrée
$25,000 et l'investissement $133,000 - $309,000 de CoffeeNow avec une autre fiche issue de la même recherche.
- Lire
available_locations pour voir où CoffeeNow propose des unités et quels États la fiche exclut.
- Vérifier
training_provided et financing_assistance avant un premier échange avec l'enseigne.
| Code |
Sens |
400 |
Requête vide, URL de liste, ou domaine hors franchisedirect.com |
401 |
Clé API absente |
404 |
La page n'est pas une fiche franchise |
500 |
Échec de la récupération |
Franchise Direct Search
