World » Export Options » JSON Format | XML Format

Event Export Feed: JSON 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 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",
}
]