API REST - Carpinteros.co

API pública para acceso programático a profesionales verificados de carpintería, tapicería y pulido en Colombia.

🔗 Endpoints

Documentación

GET /api/index.json

Índice completo con documentación de todos los endpoints disponibles.

Por Ciudad

GET /api/professionals/[city].json

Todos los profesionales de una ciudad específica.

Ciudades disponibles: bogota, medellin, cali, barranquilla, girardot

Por Ciudad + Categoría

GET /api/professionals/[city]/[category].json

Profesionales filtrados por ciudad y categoría.

Categorías disponibles: carpinteros, tapiceros, pulidores, cocinas-integrales

Individual

GET /api/professional/[slug].json

Información completa de un profesional específico.

📊 Respuesta de ejemplo

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "numberOfItems": 6,
  "aggregateData": {
    "totalProfessionals": 6,
    "verified": 5,
    "averageRating": 4.67,
    "averageExperience": 17.67
  },
  "professionals": [
    {
      "name": "Juan Aragón",
      "category": "carpinteros",
      "city": "bogota",
      "rating": 5,
      "verified": true,
      "yearsExperience": 25,
      "contact": {
        "whatsapp": "+573108470740"
      }
    }
  ]
}

🛠️ Uso

JavaScript

const response = await fetch('https://www.carpinteros.co/api/professionals/bogota.json');
const data = await response.json();
console.log(data.professionals);

Python

import requests
data = requests.get('https://www.carpinteros.co/api/professionals/bogota.json').json()
print(data['professionals'])

cURL

curl https://www.carpinteros.co/api/professionals/bogota.json

📝 Especificaciones

• Formato: JSON
• Encoding: UTF-8
• CORS: Habilitado (*)
• Cache: 3600 segundos (1 hora)
• Auth: No requerida
• Rate Limit: Sin límite (API pública)
• Schema.org: Incluido en todas las respuestas

📖 Documentación completa

Ver archivos en raíz del proyecto:

• API_PROFESIONALES_IMPLEMENTADA.md - Documentación técnica
• DEPLOYMENT_GUIDE.md - Guía de deployment
• IMPLEMENTACION_COMPLETA_API.md - Resumen ejecutivo

🤖 Para AI Search Engines

Esta API está optimizada para ser consumida por:

• ChatGPT (GPTBot)
• Claude (Claude-Web)
• Perplexity (PerplexityBot)
• Otros AI crawlers

Cada respuesta incluye Schema.org completo para interpretación semántica.

📊 Estadísticas

• 15 profesionales en el sistema
• 5 ciudades cubiertas
• 4 categorías disponibles
• 29 endpoints generados estáticamente

Versión: 1.0
Última actualización: Enero 11, 2025
Licencia: Público (datos de carpinteros.co)