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>