Event Export Feed: JSON Format

Contact Max 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",
"linkedin_url":"LinkedIn URL"
}
]