Skip to main content

Open Data APIs

Documentation about Open Data API access

Just getting started?

This guide is intended for users who are experienced using APIs but have questions about our system’s quirks. If you want to learn about APIs and how to use them we recommend this introduction to APIs from Temple University Libraries. 

Note: Videos on this page demonstrate the steps described in the text. They have no sound.

Tips for API access on NYC Open Data

What language does it use?

Our API uses the Socrata Query Language (SoQL) which borrows from Structured Query Language (SQL). If you’re already familiar with SQL, you can learn SoQL easily.

Only showing 1,000 results?

Is the API download not including all of the results? By default, the API only returns 1,000 records per request. By using the offset or limit parameters you can expand your results.

Can’t find the API endpoint?

Don’t know where to find the API information on a dataset’s primer page? On the top right of the screen you’ll see the Action button. When you select it there is an API option in the menu.

There will be an API export pop up menu that has the API endpoint link, and the option to select SODA3 or SODA2.