The CitySpark event listing service and platform offers unique flexibility for creating custom menu links, site buttons, and more. The syntax structure below will guide you to the perfect URLs for your purpose.
Structure and Parameters
There are multiple syntax methods for structuring URLs; we recommended using query string parameters:
#!/show/?category=xx&start=xx&end=xx&view=xx &location=xx&distance=xx&pick=xx&search=xx
Example Fall/Halloween URL (with map view):
yourdomain.com/calendar/#!/show/?category=400,10177,10174,10229,10035,10036,10037,10213&view=map&start=10-01-2018&end=10-31-2018
*Note the categories used: 400 (Halloween), 10177 (fall), 10174 (Oktoberfest), 10229 (hayrides), 10035 (corn mazes), 10036 (haunted houses), 10037 (pumpkin patches), 10213 (paranormal)*
Example Venue URL:
yourdomain.com/calendar/#!/show/?search=red%20rocks%20park
Parameter // Query // Term Value
Categories // category // comma separated list of category IDs
Start Date // start // yyyy-mm-dd (see additional special formats below)
End Date (for map view) // end // yyyy-mm-dd
View // view // “list,” “tile,” or “map”
Center Point // location // city,st, address, or postal code
Radius // distance // number of miles or kilometers
Editor’s Picks // pick // “true”
Search Term // search // keyword, venue name, or phrase
Labels // ser=labels: // comma separated list (case sensitive)
Helpful Hints
Use “%20” to replace spaces in the URL, such as between words in a phrase or in an address
Center point and radius are only necessary if you wish to differ from the default portal settings
Start date allows for beginning with a specific future date (leaving this out will default to today); also can be useful for SEO optimized links (see special formatting below)
End date is primarily only useful for use with the map view
When using a search term or keyword, use the minimum number of words that is specific enough to return the desired results (e.g., use only one, two or three words from a long venue name)
Special Start Date Format
In some cases, adding links to your site’s footer or metadata may enhance your SEO value and facilitate indexing of your future content. The formats below allow this to be easily done.
*Special Start Date Parameter // Query Format // Explanation*
Specific number of days into future // start=a7 //Will always start x days into the future; a7=one week from today, a30=one month, etc.
Specific day relative to current week // start=d5 // d1=Monday of current week, d2=Tuesday, etc.; d12=Friday of the following week