Jazz Near You

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",
}
]

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.