L'API REST Prospya.

Authentification

Créez une clé dans Compte → API et envoyez-la avec chaque requête :

Authorization: Bearer ld_your_key

GET /api/v1/search

Gratuit. Mêmes filtres que sur le site : q (texte libre, ex. « plombiers à lyon sans site »), category, city, region, has_phone=1, has_email=1, has_instagram=1, has_website=0|1, rating_min, reviews_min, reviews_max, page. Les coordonnées restent masquées tant que vous ne les débloquez pas.

curl -H "Authorization: Bearer $PROSPYA_KEY" \
  "https://prospya.com/api/v1/search?category=plumber&city=Lyon&has_email=1"

{"total": 38, "page": 1, "page_size": 25,
 "results": [{"id": 1042, "name": "…", "category": "Plumber", "city": "Lyon",
              "rating": 4.9, "has_phone": true, "has_email": true, "unlocked": false, …}]}

POST /api/v1/unlock

1 crédit par commerce avec un téléphone ou un email, gratuit si vous l'avez déjà débloqué. Jusqu'à 500 ids par appel.

curl -X POST -H "Authorization: Bearer $PROSPYA_KEY" -H "Content-Type: application/json" \
  -d '{"ids": [1042, 1043]}' https://prospya.com/api/v1/unlock

{"credits_spent": 2, "credits": 23,
 "records": [{"id": 1042, "name": "…", "phone": "04 …", "email": "…", "website": "…", "unlocked": true, …}]}

GET /api/v1/me

Votre email et votre solde de crédits.

Erreurs

401 invalid_api_key · 402 not_enough_credits · 400 no_ids. Besoin de plus gros volumes ? Contactez-nous.