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>
		<linkedin_url>LinkedIn URL</linkedin_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>