UK Community Arts Groups API

Discover local performing arts groups with open, developer-friendly data.

Use this API to explore community arts groups across the UK, with filters for location, category, and status.

Free & Open: No API keys required. No authentication needed. Just start making requests!

Get Started

Explore our interactive OpenAPI/Swagger documentation to see all available endpoints, request parameters, response schemas, and try out the API directly in your browser.

Interactive API Docs OpenAPI Schema (JSON)

Quick Start Examples

Example: List Arts Groups 
curl https://artsnearme.uk/api/v1/arts/groups/
Example: Get Arts Group by Slug 
curl https://artsnearme.uk/api/v1/arts/groups/southampton-arts-group/
Example: Filter Arts Groups 
curl "https://artsnearme.uk/api/v1/arts/groups/?county=hampshire&search=theatre"

Arts Groups Endpoint

Browse and search arts groups with filtering by location, category, and status.

  • GET /api/v1/arts/groups/
    List all arts groups (paginated)
  • GET /api/v1/arts/groups/{slug}/
    Get arts group by slug or UUID

Rate Limiting

All endpoints are rate-limited to 100 requests per hour per IP address.

Rate limit headers are included in all responses:

  • X-RateLimit-Limit - Maximum requests per hour
  • X-RateLimit-Remaining - Remaining requests
  • X-RateLimit-Reset - Reset timestamp

Pagination

List endpoints support offset-based pagination:

  • page - Page number (default: 1)
  • page_size - Results per page (default: 20, max: 100)

Responses include count, next, and previous fields.

Filtering & Search

Arts Group Filters

  • county - Filter by UK county
  • town - Filter by town/city
  • category - Filter by category slug
  • district - Filter by admin district slug
  • locality - Filter by locality slug
  • status - Filter by arts group status
  • search - Text search in name, description, location

Data Privacy

We take data privacy seriously. The API only exposes public arts groups information. Sensitive GDPR fields (contact emails, submitter names, consent data) are never included in API responses.