API Documentation | Conference Venues SA

Base URL

https://conferencevenues.co.za/api

Endpoints

GET /api/search?q={query}

Full-text search across venue names, descriptions, and locations. Results ranked by relevance.

Example:

curl "https://conferencevenues.co.za/api/search?q=cape+town+hotel+wifi"

GET /api/venues

List and filter conference venues. All parameters are optional.

Parameter	Type	Description
province	string	gauteng, western-cape, kwazulu-natal, eastern-cape, free-state, north-west, mpumalanga, limpopo, northern-cape
city	string	City name (e.g. "Cape Town", "Johannesburg")
type	string	hotel, conference-centre, lodge, guest-house, resort, wine-estate, casino, country-club, university
capacity	integer	Minimum capacity required
amenity	string	wifi, parking, catering, accommodation, projector, air-conditioning, team-building, wheelchair-accessible
limit	integer	Results per page (default 20, max 100)
offset	integer	Pagination offset (default 0)

Examples:

# Hotels in Gauteng with capacity for 200+
curl "https://conferencevenues.co.za/api/venues?province=gauteng&type=hotel&capacity=200"

# Venues with Wi-Fi in Cape Town
curl "https://conferencevenues.co.za/api/venues?city=Cape+Town&amenity=wifi"

# All conference centres
curl "https://conferencevenues.co.za/api/venues?type=conference-centre"

GET /api/venues/{slug}

Get full details for a specific venue including contact info, amenities, images, rooms, and pricing.

Example:

curl "https://conferencevenues.co.za/api/venues/sandton-convention-centre"

GET /api/provinces

Get a summary of all 9 provinces with venue counts.

curl "https://conferencevenues.co.za/api/provinces"

Response Format

All responses are JSON. Venue objects include:

{
  "slug": "sandton-convention-centre",
  "name": "Sandton Convention Centre",
  "province": "gauteng",
  "city": "Sandton",
  "type": "conference-centre",
  "capacity_max": 10000,
  "description": "...",
  "description_long": "...",
  "star_rating": 4.5,
  "contact": {
    "phone": "...",
    "email": "...",
    "website": "...",
    "address": "...",
    "lat": -26.1076,
    "lng": 28.0567
  },
  "amenities": ["wifi", "parking", "catering", "air-conditioning"],
  "images": [{ "url": "...", "alt": "...", "is_primary": 1 }]
}

For AI Agents

This API is designed for AI assistants to programmatically find venues. Our robots.txt explicitly welcomes AI crawlers (GPTBot, ClaudeBot, PerplexityBot). See also:

llms.txt — Structured directory overview for LLMs
ai-plugin.json — OpenAI plugin manifest
openapi.json — OpenAPI 3.0 specification
sitemap-venues.xml — All venue URLs

Rate Limits

No authentication is required. Please limit requests to 60 per minute. Responses are cached at the edge for 5 minutes.