Reference

API documentation

Demo endpoint used on this site. The commercial Business API may omit some optional link fields and will add authenticated access for subscribers.

Overview

GET /api/event-public

JSON endpoint that returns upcoming, geo-filtered events ordered ascending by start time. Each response is localized to a single language.

Host: https://businessapi.eventwall.app (use this site locally for the live demo).

Query parameters

Param Type Required Notes
lng double? No Longitude
lat double? No Latitude
radius int? No Meters; capped at 15000
days int? No Days ahead; demo clamped 1–3
lang string? No en or es — response includes only that language’s text fields

Date window

Server-side window runs from yesterday (Now − 1 day, date only) through Now + days.

That means events that started yesterday may still appear, alongside everything upcoming within the requested horizon.

Sample request

GET https://businessapi.eventwall.app/api/event-public?lng=-4.42&lat=36.72&radius=5000&days=3&lang=en

Sample response

Single-language shape. Some optional link fields may be omitted in the commercial product.

{
  "days": 3,
  "radius": 5000,
  "language": "en",
  "events": [
    {
      "id": 12345,
      "name": "Sunset Jazz on the Terrace",
      "summary": "Live jazz with sea views",
      "description": "An evening of acoustic jazz on the terrace with sea views and...",
      "category": "Jazz",
      "price": "12€",
      "startDate": "2026-07-20",
      "startTime": "20:00:00",
      "imageCover": "https://cdn.example.com/image/event/example.jpg",
      "location": "Muelle Uno",
      "googlePlaceId": "ChIJ…",
      "moreInfo": "https://example.com/ev...",
      "linkInstagram": "https://instagram.com/example",
      "linkWebsite": "https://example.com",
      "language": "en"
    }
  ]
}

Field notes

  • JSON is camelCase.
  • Text fields are returned in one language only, matching lang (en or es).
  • category — event category (platform sub-tag, with parent tag as fallback).
  • summary — short blurb; description — longer text (truncated with ... in demos when long).
  • imageCover — public image URL when present.
  • location — place name; googlePlaceId follows it when available.
  • moreInfo — primary “more info” link.
  • startDate is yyyy-MM-dd; startTime is usually HH:mm:ss.
  • Events are upcoming geo-filtered results, ordered ascending by start time.
Product note: The Business API response may evolve — optional link fields may be trimmed for subscribers. Design clients around identity, schedule, location, category, imageCover, and primary links.

Next steps

Try the live Málaga feed in the playground, then email us for pricing and city access.

Open playground info@eventwall.app