World » Jazz Near You » Event Export Feed: JSON Format

Event Export Feed: JSON 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 JSON Feed Format

This represents a single record. Additional events would be included within the <events> tag.

[
{
"name":"Event Title 1",
"start":"Unix timestamp",
"description_native":"Description of Sample Event 1",
"description_english":"English description of Sample Event 1",
"price":"30",
"currency":"EUR",
"ticket_url":"ttp://www.sample-ticket-broker.com",
"venue":{"name":"","city":"","country":""},
"festival":{"name":"","city":"","country":""},
"musicians":[{"name":""},{"name":""}]
}
]

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 JSON Feed Format

This represents a single record. Additional entities would be included within the <entities> tag.

[
{
"type":"type",
"name":"name",
"phone":"phone number",
"email":"email address",
"country":"Country",
"city":"City",
"state":"State",
"zip":"Zip code",
"longitude":"longitude",
"latitude":"latitude",
"address":"Street address",
"description_native":"Description of Sample Event 1",
"description_english":"English description of Sample Event 1",
"website_url":"Website URL",
"facebook_url":"Facebook URL",
"twitter_url":"Twitter URL",
}
]

Comments

Engage

Publisher's Desk
Viva la technology and Album Reviewers Wanted
Read on...
Contest Giveaways
Enter our latest contest giveaway sponsored by Outside in Music

Get more of a good thing!

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

Install Jazz Near You

iOS Instructions:

To install this app, follow these steps:

Jazz Near You would like to send you notifications

Notifications include timely alerts to content of interest, such as articles, reviews, new features, and more. These can be configured in Settings.