{
    "api": "Spanish Companies API - Empresas Españolas",
    "version": "1.0.0",
    "description": "API para obtener datos de cualquier empresa española a partir de su CIF\/NIF",
    "endpoints": [
        {
            "action": "empresa",
            "method": "GET",
            "params": {
                "cif": "(requerido) CIF\/NIF de la empresa. Ej: A28015865"
            },
            "description": "Devuelve ficha completa: nombre oficial, dirección, teléfono, web, coordenadas GPS",
            "ejemplo": "?action=empresa&cif=A28015865"
        },
        {
            "action": "buscar",
            "method": "GET",
            "params": {
                "nombre": "(requerido) Nombre de la empresa",
                "limit": "(opcional) Máx resultados, default 20, max 50"
            },
            "description": "Busca empresas por nombre y devuelve CIF + datos de contacto",
            "ejemplo": "?action=buscar&nombre=TELEFONICA"
        },
        {
            "action": "stats",
            "method": "GET",
            "description": "Estadísticas de cobertura de la base de datos"
        }
    ],
    "auth": {
        "header": "X-API-Key: tu_clave",
        "param": "&api_key=tu_clave",
        "free": "50 consultas\/mes sin API key"
    },
    "coverage": "635,000+ empresas en base de datos"
}