WORLD
   
 
 


event.add



[HTTP POST] only (authentication required)

endpoint: http://www.spraci.com/services/REST/

Fields:

method: event.add (Required)

format: (optional)
if you wish to change the format of the response (json,xml,serialize,flashvars)

username: (Required if no current validsession cookie present)
Your SPRACI username.

password: (Required if no current valid session cookie present)
Your SPRACI password.

name: (Required)
The name of the event.

event_id: (Optional)
The spraci id of the event. If provided (and you are the creator of the event listing), the submission will update that event instead of adding a new listing

area: (spraci area/city keyword, required)
The area/city/state/country of the event.
To get a list of areas you can use area.getlist.
Make sure you choose the area most local to where the event is located.
(if its in a certain city and the city is in the list of areas choose that city rather than the state or country. It will still also appear in the appropriate state/country listings)

tags: (Keywords, Optional)
a list of categories or tags associated with the events (such as the type of event, styles of music, etc)

start_date: (YYYY-MM-DD hh:mm:ss, Required) The start date of the event

end_date: (YYYY-MM-DD hh:mm:ss, Optional)
The end date of the event

start_time: (HH:MM, Optional)
The start time of the event. (if not provided in start_date)

end_time: (HH:MM, Optional)
The end time of the event. (if not provided in end_date)

venue:
(string) The venue (name, address) where the event will be held.
Try to use a format suitable format for geocoding where possible. (especially If you are not also providing lat/lon information)

venue_id: (optional)
The spraci venue_id (integer) of a venue listed in spraci.
If the venue has lat/lon information it will be used for displaying maps without any need to provide lat/lon in the submission.

description: (Optional)
A brief description of the event.

blurb: (Optional)
Description of the event. (can be long)

lat: (Optional)
Latitude of event location for displaying maps

lon: (Optional)
Longitude of event location for displaying maps

image: (Optional)
url of image (can be a flyer image or picture - must be a url starting with http://

linkurl: (optional)
url of page or site associated with the event
must start with http://

linkname: (optional)
label of "linkurl"
if a link is submitted and no linkname is provided, it will be "MORE INFO"

ticketurl: (optional)
url of page for buying tickets to the event
must start with http://

callback: (optional - JSON format only)
A single-word name of your javascript callback function.



Response:
If the event was successfully submitted you will get the event data returned much like event.show and it will contain the id of the event.


Please Note: The timezone for dates is assumed to be the timezone of the city/area you have chosen.
Do not add timezones to dates or convert them to any other timezone.

date formats can be YYYY-MM-DD or YYYY-MM-DDThh:mm:ss
eg: 2011-03-10 20:00:00 or 2011-03-10T20:00:00

Rate Limit: please leave a couple of seconds between submissions if you are adding a lot of events. (it won't let you submit more than once per second)

If you wish to check your submissions, they will appear in 'my events just like events added via the forms on spraci.

For test submissions please use 'x0test' as the area.
Please do not leave test listings in any real cities or areas!



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!