La API REST de Prospya.

Autenticación

Crea una clave en Cuenta → API y envíala con cada solicitud:

Authorization: Bearer ld_your_key

GET /api/v1/search

Gratis. Los mismos filtros que en la web: q (texto libre, p. ej. "fontaneros en lyon sin web"), category, city, region, has_phone=1, has_email=1, has_instagram=1, has_website=0|1, rating_min, reviews_min, reviews_max, page. Los contactos siguen ocultos hasta que los desbloqueas.

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édito por comercio con teléfono o email, gratis si ya lo desbloqueaste. Hasta 500 ids por llamada.

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

Tu email y tu saldo de créditos.

Errores

401 invalid_api_key · 402 not_enough_credits · 400 no_ids. ¿Necesitas más volumen? Contáctanos.