Private Beta Feature
This documentation covers a feature currently in Private Beta. Access is exclusive to approved participants. If you're interested in joining the Private Beta program, apply here.
Please note that while the docs are publicly viewable, functionality is limited to Private Beta participants until public launch.
Once you've received confirmation of acceptance into the Private Beta program, please complete the following steps to get up and running with your first Personalization API call.
To create a Foursquare developer account, please sign up here.
The first order of business is creating a project to associate your application with. You can have multiple projects, each with their own settings, members and API keys.
Please refer to the Create a New Project how-to guide for step-by-step instructions.
Before you can use the Personalization APIs, you must first generate a Service API Key that will be used to create Foursquare Managed Users for your application.
Please refer to the Manage Your Service Account how-to guide for step-by-step instructions.
All of the Personalization APIs are considered "user-ful" and require your application to pass an OAuth token on behalf of each individual user with each call.
Use the Service API Key you created in the previous step to authenticate against the Create Managed User endpoint.
Please refer to the Create Managed User Endpoint Builder to create a managed user and retrieve the resulting
oauth_token and corresponding
With the resulting
oauth_token, you can now make a call to any of the Personalization APIs.
For a complete list of the Personalization APIs, please refer to the Personalization APIs Overview.