Yelp API Key: Difference between revisions

From CommunityData
(Creating notes on how to get an API key.)
 
(Adding a picture describing an example app.)
Line 4: Line 4:


After signing in, you'll see a page with fields for a name, description, and such. You'll want to give this a unique name - Your name, plus "CDSW 2020" is probably a good choice. For Industry, select Student. If you signed up with an email address, you can use the same email address in the contact address field, and your description can just be a comment about how it's a data science project for a course.
After signing in, you'll see a page with fields for a name, description, and such. You'll want to give this a unique name - Your name, plus "CDSW 2020" is probably a good choice. For Industry, select Student. If you signed up with an email address, you can use the same email address in the contact address field, and your description can just be a comment about how it's a data science project for a course.
[[File:Yelp app details.png|center|frame|600px|An example app description and name.]]


You will want to look through the API terms of use; our specific case is allowed for under the non-commercial data analysis clause. If you're interested in using Yelp's data for commercial purposes, they have a separate license for that! Otherwise, since we won't be displaying results to end users and we'll really only be handling this data as aggregates, we're completely within their terms.
You will want to look through the API terms of use; our specific case is allowed for under the non-commercial data analysis clause. If you're interested in using Yelp's data for commercial purposes, they have a separate license for that! Otherwise, since we won't be displaying results to end users and we'll really only be handling this data as aggregates, we're completely within their terms.

Revision as of 02:22, 27 January 2020

Web services that offer APIs (such as Yelp) want to know who's using their services; the way they do this is by requiring each developer (that's you!) building an app, or in this case your project, to have a key that your code will use every time it asks Yelp for information.

To begin, go to the Yelp developer documentation page and click on "Create app" on the left. You'll be asked to sign in; if you already have a Yelp account, you can use that; if you want to create a new account or use one of the service integrations, use those.

After signing in, you'll see a page with fields for a name, description, and such. You'll want to give this a unique name - Your name, plus "CDSW 2020" is probably a good choice. For Industry, select Student. If you signed up with an email address, you can use the same email address in the contact address field, and your description can just be a comment about how it's a data science project for a course.

An example app description and name.

You will want to look through the API terms of use; our specific case is allowed for under the non-commercial data analysis clause. If you're interested in using Yelp's data for commercial purposes, they have a separate license for that! Otherwise, since we won't be displaying results to end users and we'll really only be handling this data as aggregates, we're completely within their terms.

You can choose whether or not you want to receive emails; if you want to use Yelp's developer tools a lot in the future, this may be useful.

After creating your key, you'll want to copy down the Client ID and Key values, and save them somewhere close to your project. These values are all Yelp knows to relate your work to you.