Home

Localist API

For terms of use, concepts and resources, Localist’s master API documentation can be found here: http://www.localist.com/doc/api

Basic Rules

  • Localist’s API is read-only and publicly accessible.
  • Calls will pull 10 items per page by default, but can be increased to up to 100 per page (this is well-above industry standard).
  • The maximum date range that the API call pull from is 370 days from today or the start date you specify.
  • If a start date is not specified, then the API will default to only pulling event data from today.

Building an API Call

All API calls must start with http://your.custom.domain/api/2/

  • Events: http://your.custom.domain/api/2/events
  • Places: http://your.custom.domain/api/2/places
  • Groups: http:/your.custom.domain/api/2/groups

Paging: http://your.custom.domain/api/2/events?type=38570&pp=100&page=1

  • This will pull 100 results per page so to access the next 100 you would change the 1 in page=1 to 2, etc.

Date Range

  • Start and End date: http://your.custom.domain/api/2/events?type=38570&pp=100&page=1& start=2014-10-01&end=2014-11-01
  • Today + number of future days: http://your.custom.domain/api/2/events?days=90 (the maximum is 370 days).

API Token

Since the Localist API is publicly accessible, only public info is available. Things that aren’t public surround user data, so for example, who is attending an event. A token tells the API, “this is a trusted person”, and allows them to access the private data — think of this like a password. To give someone a token, you’ll need to follow the steps below:

  1. Navigate to the Admin Dash > Settings > Apps
  2.  On the righthand side of the page, click ‘Add App
  3. Fill out Name (this can be internal, like ‘Localist Integration’) and App Website (the URL where the data will be used or your main domain)
  4. Click ‘Save Changes
  5. Click ‘Manage Access Tokens‘ in the top right corner > +Create Access Token > Fill out details > Create Token
  6. You’ll see the token on the resulting page, which you can pass along to the person who needs access to private data in the API