Event Export Feed: XML Format
Contact us to review the requirements prior to creating your feed.
Events
Feed fields include:
Required
- title
- start (includes date and time)
- venue name and/or festival name (location is required to distinguish venues that share the same name)
Remaining
- musician names
- price
- currency code (e.g. USD, EUR, GBP)
- native description
- English description
- ticket URL
Feed records are skipped if:
- A direct match is not found on a venue or festival name. Jazz Near You matches on the name to determine location.
- A required field is missing.
Sample XML Feed Format
This represents a single record. Additional events would be included within the <events> tag.
<events> <event> <title>Event Title 1</title> <start>Unix timestamp</start> <description> <native>Description of Sample Event 1</native> <english>English description of Sample Event 1</english> </description> <price>50</price> <currency>USD</currency> <ticket_url>//www.sample-ticket-broker.com</ticket_url> <venue> <name>Venue Name</name> <city>City Name</city> <country>Country Name</country> </venue> <festival> <name>Festival Name</name> <city>City Name</city> <country>Country Name</country> </festival> <musicians> <name>Musician Name 1</name> <name>Musician Name 2</name> <name>Musician Name 3</name> <name>Musician Name 4</name> </musicians> </event> </events>
Entities
For our international partners, we require a one time import of venue and festival data and we do this prior to importing events. The fields and format for venues and festivals are as follows...
Feed fields include:
Required All (including U.S.)
- type (venue or festival)
- name
- address (street address only)
- city
- country
Required U.S. only
- zip code
- state
Remaining
- longitude (DDD.dddd)
- latitude (DDD.dddd)
- native description
- English description
- links (see options below)
Sample XML Feed Format
This represents a single record. Additional entities would be included within the <entities> tag.
<entities> <entity> <type>type</type> <name>name</name> <contact> <email>email</email> <phone>phone</phone> <website_url>Website URL</website_url> <facebook_url>Facebook URL</facebook_url> <twitter_url>Twitter URL</twitter_url> </contact> <location> <country>Country</country> <state>State</state> <zip>Zip code</zip> <city>City</city> <longitude>longitude</longitude> <latitude>latitude</latitude> <address>Street address</address> </location> <description> <native>Description of Sample Event 1</native> <english>English description of Sample Event 1</english> </description> </entity> </entities>