WORLD
   
 
 


fast event search by location or area



[HTTP GET]

Events search by geo location or city/area.

This is the recommended event search method for websites and apps.
It's faster than the other methods and can show events with permissions other than public when logged in.

endpoint: http://www.spraci.com/cgi-bin/ejson.cgi

returns: events listings in json format for a chosen city/area or within a given distance from lat/lon location for chosen categories
Listings are returned in date order. (starting from a few hours before the current time based on the timezone of a selected area)

Arguments:

parea (keyword):
The area keyword of area/city/state/country of the event.
To get a list of area keywords you can use "code" from area.getlist.

lat:
Latitude (for location search) in decimal floating point format.

lon:
Longitude (for location search) in decimal floating point format.

within (km):
Maximum distance in kilometers (decimal floating point) from lat/lon location provided for which listings will be shown.

q: (search terms/keywords/tags)
a tag or keyword or comma delimited list of tags or search terms to search for within the chosen area or location range.

categories:
comma separated list of tags

start (integer):

Start display of listings after <start> entries (for pagination)

end (integer):

Stop display of listings after <stop> entries (for pagination)

callback (function name):
If provided the output will be wrapped as a call to a javascript callback function.

friends:
If set with anything (eg 1) only your friends' events will be shown (this feature requires you to be logged in)

follow:
If set with anything (eg 1) events for people in your follow list will be shown (this feature requires you to be logged in)

user_id:
A SPRACI numeric user id - to show event listings owned by that user.

pretty:
If set the output will be nicely indented so that it is easy to see the structure of the output for development. (for production versions remove it for speed)

Either parea or lat + lon + within are required.
If parea is provided it will be also be used to help find events within that area (without it searches are confined to within a few degrees longitude). You can specify a city/state/country in parea or q to help cover a wider area.

If lat + lon + parea are provided (without within) distances from chosen location are still shown in the output if available.

The optional q or categories will return results for any of the terms found within the chosen area or location range.
Up to 100 events are shown by default (use start and end to change this, do pagination, etc)


Example Queries:

http://www.spraci.com/cgi-bin/ejson.cgi?q=electro,dubstep,psytrance,drumnbass,breaks,trance,house,hiphop&lat=-33.8779426&lon=151.22288&within=10&pretty=1

http://www.spraci.com/cgi-bin/ejson.cgi?parea=x0sydney&q=electro,dubstep,psytrance,drumnbass,breaks,trance,house,hiphop


Example responses:
(a selection to give you an idea of what can be returned - real responses can be quite long)

{
	"224618":	{
		"event_id":	"224618",
		"dtstart":	"2011-06-12",
		"time":	"10:30pm - 6am",
		"title":	"Aether Party",
		"venue":	"Metro Theatre, 624 George St, Sydney",
		"description":	"Aether Party - Headlined by Legendary Trance Duo Agnelli&Nelson 
live: Agnelli&Nelson
djs: Agnelli&Nelson, Matt Bachl
visuals: Hypnotic Lazers by award winning Paul Marin Productions
Brace yourself and get ready to embark on a true trance experience with Aether Party. Experience a night of raw edged and heart pumping trance music, brought to you by the legendary Trance Duo Agnelli & Nelson. The same duo compiled and mixed the album with some of the best tracks from around the world in Trance World 7.", "user_id": "59518", "venue_id": "10353", "lat": "-33.87533362", "lon": "151.20670136", "url": "http://www.spraci.com/events/224618", "website": "www.aetherparty.com.au", "date_text": "Sunday 12th June 2011", "address": "624 George St, Sydney", "postcode": "2000", "tags": "sydney nsw australia rave live student trance nrgtrance aether ", "distance": "1.5216" }, "225568": { "event_id": "225568", "dtstart": "2011-06-12", "title": "ADULT DISCO FEATURING CLASSIXX (USA)", "venue": "Oxford Art Factory, 42 Oxford St, Darlinghurst", "description": "Adult Disco is throwing an all night love affair with LA disco men Classixx.", "venue_id": "170333", "lat": "-33.8780273", "lon": "151.21384621", "url": "http://www.spraci.com/events/225568", "website": "http://www.oxfordartfactory.com/", "date_text": "Sunday 12th June 2011", "address": "42 Oxford St., Darlinghurst", "tags": "sydney nsw australia house ", "distance": "0.8341" }, "223974": { "event_id": "223974", "dtstart": "2011-06-16", "time": "7pm", "title": "DANIEL BOYS - SO CLOSE", "venue": "Slide, 41 Oxford Street, Darlinghurst", "description": "One of Britain's brightest musical theatre talents, Daniel Boys became a household name in 2007 when he starred in the BBC/ UKTV talent show 'Any Dream Will Do '. An award-winning West End performer, Daniel has starred in major productions across the UK and Europe including Rent, West Side Story, and Avenue Q. Daniel also performed at Andrew Lloyd Webber's 60th Birthday Celebration concert and is a regular performer on the legendary BBC radio show 'Friday Night is Music Night '.", "venue_id": "169982", "lat": "-33.877969", "lon": "151.213245", "url": "http://www.spraci.com/events/223974", "website": "http://www.slide.com.au/", "date_text": "Thursday 16th June 2011", "address": "41 Oxford Street, Darlinghurst", "postcode": "2010", "tags": "sydney nsw australia cabaret theatre ", "distance": "0.8895" }, "225699": { "event_id": "225699", "dtstart": "2011-07-08", "time": "10pm - 4am", "title": "INDEX feat ROCKWELL", "venue": "Tone, 16 Wentworth Avenue, Surry Hills Nsw", "description": "Future Bass Sessions in July with INDEX.
This is all the promo you should need,
http://www.youtube.com/watch?v=iJ-JWwkM_iY
If thats not enough,
www.voidsound.com/mixes/FACTmix232_Rockwell.mp3
And some words about the one like ROCKWELL,", "venue_id": "177188", "lat": "-33.87794260", "lon": "151.21178627", "url": "http://www.spraci.com/events/225699", "website": "http://www.facebook.com/event.php?eid=203578436344540", "date_text": "Friday 8th July 2011", "address": "16 Wentworth Avenue, Surry Hills, NSW", "postcode": "2010", "tags": "sydney nsw australia dubstep hiphop electro ", "distance": "1.0242" }, "224737": { "event_id": "224737", "dtstart": "2011-06-11", "time": "7pm - 3am", "title": "Flomotion Live & Beat Unique Presents:", "venue": "Ginglik, 1 Shepherds Bush Green, Shepherds Bush, W12 8PH", "description": "Flomotion & Beat Unique join forces to bring you three acts from the Beat Unique roster, at the forefront of electronic music. Mixing up electro, electronica, dubstep, drum n bass, deep and minimal house, techno, broken beat, jazz, hip hop and more.
Rotkäppchen, Alan Starck, DJ Nick Luscombe
DJ Nick Luscombe's `Flomotion' has broadcast on numerous highly regarded radio stations, including Resonance FM, NME Radio, Samurai FM and XFM.
In 2010, `Flomotion' celebrated 10 years as one of the UK's longest running weekly electronic music radio shows and highly successful regular live and club", "venue_id": "175203", "lat": "51.503834074", "lon": "-0.219421000", "url": "http://www.spraci.com/events/224737", "website": "http://www.ginglik.co.uk", "date_text": "Saturday 11th June 2011", "address": "1 Shepherds Bush Green, Shepherds Bush", "postcode": "W12 8PH", "tags": "london england uk techno drumnbass breaks dubstep electro hiphop jazz house ", "distance": "15.558" }, "143436": { "event_id": "143436", "dtstart": "2011-06-14", "time": "9pm - 2am", "title": "Second Nature", "venue": "Manjaro - 148 Holloway rd, London, N7", "description": "Dilation's sister night teams up with Crazysexycool to bring you the best in Drum & Bass and Dubstep.
*** DJ'S - LOWFRO - RILEY - MRSA - SMOKEY*** More to be Confirmed.
We also have free SECOND NATURE T-SHIRT GIVE AWAYS
*** THE GIRL WHO LOOKS THE SEXIEST IN A SECOND NATURE T-SHIRT GETS FREE DRINKS***
CHECK OUT THE DRINK DEALS.
***BUY 2 BEERS GET ONE FREE***", "user_id": "47960", "lat": "51.5508441", "lon": "-0.1099026", "url": "http://www.spraci.com/events/143436", "date_text": "Tuesday", "tags": "london england uk drumnbass dubstep " }, "225355": { "event_id": "225355", "dtstart": "2011-06-16", "time": "7pm - 0am", "title": "Anthony C", "venue": "The Big Chill House, 257-259, Pentonville Road, King's Cross Ward", "description": "DJ Anthony C playing Dub, Breaks, IDM & Electro plus guest DJ's
djs: DJ Anthony C
DJ Anthony C playing Dub, Breaks, IDM & Electro plus guest DJ's", "venue_id": "175283", "lat": "51.530767754", "lon": "-0.120262907", "url": "http://www.spraci.com/events/225355", "date_text": "Thursday 16th June 2011", "address": "257-259, Pentonville Road, King's Cross Ward", "postcode": "N1 9NL", "tags": "london england uk club " }, "226812": { "event_id": "226812", "dtstart": "2011-06-17", "time": "10pm - 6am", "title": "Road 2 Nass", "venue": "Proud @ Matter, Peninsula Square, London", "description": "London leg of the Road 2 Nass tour
live: FABIO & GROOVERIDER ft HARRY SHOTTA, ORIGINAL SIN ft EKSMAN,DRUMSOUND & BASSLINE SMITH ft SHABBA, TAXMAN & SUB ZERO ft FELON, MATRIX & FUTUREBOUND ft DARRISON, SIGMA & BLAME ft MASTER X , MR NICE ft JONNY G, PREMISE ft CRISIS
Drum & Bass back where it belongs, the start of big things to come.
FRIDAY 17TH JUNE
Proud2 at The 02 (fka Matter)
Friday 17th June at Proud2 plays host to the London (and final) leg of the Road 2 Nass tour.. Setting the pace for Europe’s leading extreme sports and music festival (www.nassfest.com).", "user_id": "59827", "venue_id": "174575", "lat": "51.50289901", "lon": "0.0034410012", "url": "http://www.spraci.com/events/226812", "website": "http://proud2.viewtickets.co.uk/", "date_text": "Friday 17th June 2011", "address": "Peninsula Square, London", "postcode": "SE10 ODY", "tags": "london england uk drumnbass " }, "220320": { "event_id": "220320", "dtstart": "2011-06-18", "dtend": "2011-06-19", "title": "High Definition Dance Festival", "venue": "Forest Farm, Ilford, Essex", "description": "High Definition Dance Festival
June 18th & 19th 2011
Forest Farm, Ilford, Essex
IG6 3HQ
http://www.hdfest.co.uk/
Welcome to the High Definition Dance weekender!", "user_id": "26041", "lat": "51.500197", "lon": "-0.126197", "url": "http://www.spraci.com/events/220320", "website": "http://www.hdfest.co.uk", "date_text": "18th June 2011 - 19th June 2011", "tags": "london colchester chelmsford england uk techno house trance electro ", "distance": "9.5282" }, "220631": { "event_id": "220631", "dtstart": "2011-06-21", "title": "Assemblage 23", "venue": "Nachtleben, Kurt-Schumacher-Strae 45, Frankfurt am Main", "description": "live: Assemblage 23 , Architect , Abstract Decay , Slave Republic
More info at www.mortsubite.de", "venue_id": "175455", "lat": "50.113903016", "lon": "8.6877919955", "url": "http://www.spraci.com/events/220631", "website": "http://www.konstabler.com/", "date_text": "Tuesday 21st June 2011", "address": "Kurt-Schumacher-Straße 45, Frankfurt am Main", "postcode": "60313", "tags": "germany europe frankfurt electro industrial synthpop ebm gothic live ", "distance": "321.441" }, "226060": { "event_id": "226060", "dtstart": "2011-06-25", "time": "11:59pm", "title": "HIGHVOLTAGE", "venue": "Tresor, Kpenicker Str. 70", "description": "GLOBUS:
- Live: Glimpse (Crosstown Rebels, Cadenza / London)
GummiHZ (Mobilee / Berlin)
Tiger Stripes (Get Physical, Drumcode / Stockholm)
Sasse (Moodmusic / Berlin)
John Spring (Sub Static, Crosstown Rebels / Berlin)", "venue_id": "8376", "lat": "52.5105472", "lon": "13.4183621", "url": "http://www.spraci.com/events/226060", "website": "http://www.tresorberlin.de/", "date_text": "Saturday 25th June 2011", "address": "Köpenicker Str. 70, Berlin Mitte", "postcode": "10179", "tags": "germany europe berlin techno house ", "distance": "134.612" } }




If you have any questions you would like to see in here please contact us

 



FREE PUBLICITY


To list your event on spraci go to the ADD EVENT form and enter the details.
Its easy!