Hegelo Experience API – Access to Data for Developers and AI

Welcome to the official documentation of the Hegelo Experience API, the Italian platform dedicated to experiential tourism.
Here you can find how to access updated data of our tourism experiences through simple and powerful REST APIs, designed to ease integration with web apps, mobile apps, AI systems, and more.

Available API Endpoints:

Endpoint Method Description Parameters
/wp-json/hegelo/v1/experiences GET Returns a list of all published experiences limit (max results, default 50), offset (for pagination)
/wp-json/hegelo/v1/experiences/{id} GET Returns detailed info of a single experience by ID id: Experience ID
/wp-json/hegelo/v1/experiences/region/{region} GET Returns all experiences in a specific region region: region slug (e.g. emilia-romagna)
/wp-json/hegelo/v1/experiences/region/{region}/{city} GET Returns all experiences in a specific city within a region region: region slug, city: city slug (e.g. emilia-romagna/parma)

API Response Format (main fields)

  • id: Unique experience ID
  • title: Experience title
  • slug: URL-friendly slug
  • url: Direct link to the experience page on Hegelo
  • short_description: Short description
  • full_description: Full description (only for single experience detail)
  • image: URL of main image
  • created_date: Creation date
  • modified_date: Last modified date
  • adult_price: Adult price in EUR
  • address: Address or location
  • latitude, longitude: GPS coordinates
  • rating: Average rating
  • min_participants, max_participants: Min and max participants
  • what_includes: What the experience includes
  • highlights: Highlights
  • gallery: Array of gallery image URLs
  • reviews: Array of recent reviews (author, text, rating, date)
  • type, duration_category, languages, seasonality: Associated taxonomies
  • coordinates: Object with latitude and longitude
  • price: Object with price and currency
  • participants: Object with min and max participants
  • schema_org: Structured data block in schema.org format (useful for SEO and AI)

Example API call:

GET https://www.hegelo.com/wp-json/hegelo/v1/experiences?limit=10

Sample JSON response (truncated):

{
  "success": true,
  "data": [
    {
      "id": 123,
      "title": "Pottery Workshop in Caltagirone",
      "slug": "pottery-workshop-caltagirone",
      "url": "https://www.hegelo.com/experiences/pottery-workshop-caltagirone",
      "short_description": "Learn the art of pottery in a traditional Sicilian workshop...",
      "image": "https://www.hegelo.com/wp-content/uploads/2025/08/pottery.jpg",
      "created_date": "2025-01-10T10:00:00",
      "adult_price": 90,
      "address": "Caltagirone, Sicily",
      "latitude": 37.0625,
      "longitude": 14.4964,
      "rating": 4.7,
      "min_participants": 2,
      "max_participants": 10,
      "what_includes": "Materials, Instruction, Lunch",
      "highlights": "Hands-on experience, local guide",
      "gallery": [
        "https://www.hegelo.com/wp-content/uploads/2025/08/gallery1.jpg",
        "https://www.hegelo.com/wp-content/uploads/2025/08/gallery2.jpg"
      ],
      "reviews": [
        {
          "author": "Maria",
          "text": "Fantastic experience! Highly recommended.",
          "rating": 5,
          "date": "2025-07-20"
        }
      ],
      "type": ["Workshop"],
      "duration_category": ["Half-day"],
      "languages": ["Italian", "English"],
      "seasonality": ["Spring", "Summer"],
      "coordinates": {"lat": 37.0625, "lng": 14.4964},
      "price": {"adult": 90, "currency": "EUR"},
      "participants": {"min": 2, "max": 10}
    }
  ],
  "total": 120,
  "meta": {
    "limit": 10,
    "offset": 0,
    "generated_at": "2025-08-09T19:00:00+01:00",
    "source": "Hegelo.com - Experiential Tourism Italy"
  }
}

Why use Hegelo APIs?

  • Always up-to-date real-time data
  • Clear and comprehensive JSON structure
  • Support for filtering by region and city
  • Rich content with images, reviews, and SEO-friendly metadata
  • Open access without authentication (CORS enabled)
  • Perfect for integration with apps, chatbots, AI platforms, and third-party services

Contact & Support

If you encounter issues or have special requests, contact us at:
info@hegelo.com