Jazz Near You

World » Jazz Near You » Event export feed: XML format

Event export feed: XML format

Contact Michael 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>

Post a comment

Engage

Contest Giveaways
Enter our latest contest giveaway sponsored by Color Red Music
Jazz Polls
We'll return next year with another round of polls including favorite vocalists, saxophonists, trombonists and trumpet players. Until then, you can view the results to all our polls, here.
Publisher's Desk
Wanted: Jazz Album Liner Notes
Read on...

Get more of a good thing!

Our weekly newsletter highlights our top stories, our special offers, and includes upcoming jazz events near you.