Event partners
Send us your calendar
If you run a venue, festival, gallery, theatre, church, school or business district calendar in Annapolis, we can read it directly so your events stay current here without anyone retyping them.
Why become a data partner
- Your events appear in answers to questions like "what's on tonight?" — free of charge.
- Every listing credits your organisation and links back to your own page.
- Changes on your site flow through, so times and cancellations stay accurate.
- You keep control: we only read sources you have given us permission to read.
- Optional paid promotion exists, but it is never required and is always labelled.
Supported formats
We prefer them in this order, because structured data is far more reliable than reading a web page:
- Annapolis Now JSON event feed
- Schema.org Event JSON-LD
- iCalendar (ICS) feed
- RSS feed
- Partner API
- Approved HTML extraction
We never crawl the web at large. We read only the addresses a partner has supplied and an administrator has activated, we identify ourselves with a descriptive user agent, we respect page limits, and we never work around a login or access restriction.
Schema.org JSON-LD example
Add a block like this to each event page. We support Event, MusicEvent, Festival, TheaterEvent, SportsEvent, EducationEvent and related types.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "MusicEvent",
"name": "Waterfront Brass on the Dock",
"startDate": "2026-06-12T19:30:00-04:00",
"endDate": "2026-06-12T21:00:00-04:00",
"eventStatus": "https://schema.org/EventScheduled",
"url": "https://example.org/events/waterfront-brass",
"image": "https://example.org/images/brass.jpg",
"description": "Free outdoor brass concert at City Dock.",
"organizer": { "@type": "Organization", "name": "Example Arts Council" },
"location": {
"@type": "Place",
"name": "City Dock",
"address": {
"@type": "PostalAddress",
"streetAddress": "1 Dock St",
"addressLocality": "Annapolis",
"addressRegion": "MD",
"postalCode": "21401"
}
},
"offers": {
"@type": "Offer",
"price": "0",
"priceCurrency": "USD",
"url": "https://example.org/events/waterfront-brass"
}
}
</script>Annapolis Now JSON feed specification
Serve this at a stable address over HTTPS. Include an offset in every timestamp; we treat local times as America/New_York and preserve any offset you supply.
{
"version": "annapolis-now-1.0",
"organization": "Example Arts Council",
"updated_at": "2026-05-01T09:00:00-04:00",
"events": [
{
"external_id": "brass-2026-06-12",
"url": "https://example.org/events/waterfront-brass",
"name": "Waterfront Brass on the Dock",
"description": "Free outdoor brass concert at City Dock.",
"starts_at": "2026-06-12T19:30:00-04:00",
"ends_at": "2026-06-12T21:00:00-04:00",
"status": "scheduled",
"organizer": "Example Arts Council",
"venue": "City Dock",
"address_line1": "1 Dock St",
"latitude": 38.9765,
"longitude": -76.4841,
"is_free": true,
"price_text": "Free",
"ticket_url": null,
"accessibility": "Level paved access; accessible restrooms nearby.",
"categories": ["live-music", "family-friendly"],
"image_url": "https://example.org/images/brass.jpg"
}
]
}Checking your feed before you send it
- Open the address in a private browser window — it must load without a login.
- Confirm it is valid JSON (any JSON validator will do) or, for JSON-LD, run the page through Google's Rich Results Test.
- Every event needs a name, a start time with an offset, a location and a link.
- Use a stable
external_idper event so updates replace rather than duplicate. - Keep cancelled and postponed events in the feed with the status set, rather than deleting them.
Partner application
Tell us who you are and where your calendar lives. An editor reviews every application — nothing is read automatically until it is approved and activated.
Contact
Partnerships are handled by the Annapolis Now editorial team. A published partnership email address will be added here once it is live; until then please use the application form above or the contact page. Annapolis Now is an independent local information resource.