Skip to main content

This site is not affiliated with NYC government.

Posted in


Databook Update 8: Get Normalized Data from our New API

Databook has always been two projects in one.

The first project is our data pipeline that collects, normalizes and republishes normalized NYC Open Data so that other people can use it.

The second is to build a general purpose app that makes this information understandable and useful for the public.

In the beginning of the project, we used CartoDB’s API platform to publish the data that comes out of our pipeline. It was easy to deploy, fast and efficient, but it didn’t allow us to control how we share API access with the public. So, we switched to a custom solution that uses the open source FastAPI framework and PostgreSQL.

You can find our new API, along with Swagger docs, at

The code for our API is posted on Github.

We want to help people use our normalized data! If you’re interested in using another of the data used in Databook or want to use our data directly from our API, please let us know.

Databook Update 7: The City Record Online Remix

New York City’s “City Record” is the official “journal” where city agencies publish news and event information. This info includes public hearings, procurement announcements, contract awards, rule changes, auctions, personnel changes and more.

We’ve used the city’s open data version, which is updated daily, to integrate The City Record’s contents into the WeGov data system, enabling us to integrate it with the 25+ data sets we already display on Agency Profiles.

Now you can view all of an agencies CIty Record news and events on that agency’s profile. You can also subscribe to that information using the RSS and ICS/iCal feeds we provide for each agency.

We also built a front end for the City Record with a few new features. You can now see how many new items are in each of the City Record’s sections, get RSS and iCAL feeds of all items, and even browse detailed information from auctions of city property.

We hope you enjoy this update and please let us know if you have any ideas for how we can improve any of our products.

Databook Update 6: New “Civil Service Titles” Section Added

New York City government has a workforce over 300,000 people, and that workforce is structured by a system of “Civil Service Titles”. These titles define the job roles and salary of every city employee as well as the skills people need to earn that title.

This month we launched a new section called Titles where you can search and browse Civil Service Titles, view their profiles with information about their salaries and unions, and see how that title connects to other important NYC Open Datasets that describe Positions, Job Opening and Civil Lists.

  • Positions shows the number of people an agency is expected to have with a certain title (ex. the NYPD has positions for 25 Accountants.)
  • Job Openings: these are open positions associate with a civil service title (ex. the city has 13 job openings for Accountants.)
  • Civil List: these are the individuals who work for city agencies with a specific civil service title (ex. see the first initial and last name, and salaries of the 26 accountants employed by the NYPD in 2019.)

We also integrated these datasets into the People section of Agency Profiles and added a two more datasets about agency headcounts and demographics.

We’ve researched how to get more details each civil service titles such as their requirements and exam schedules but found that information hard to extract as it is in the links from this PDF of civil service exam schedules.

If you know of more or better data sources, or have ideas or proposals for what we should do next, please let us know via our community participation platform or simply send us a message.

We look forward to collaborating with you!

Databook Update 3 – September 2021

Add Districts Section where users can select district type to see district boundaries, and then click a district to see it’s Databook data.

  • Added District Types Community Districts (CBs), Council Districts (CDs) and Neighborhood Tabulation Areas (NTAs)
  • Associate mapped Capital Projects with their corresponding districts so they can be browsed by district.
  • Add rollups to see Capital Project stats on a District by District Basis”

Databook Update 1 – July 2021

We added Capital Projects section to the Databook. This involved adding new views:

  • Browse all Capital Projects, sort them by budget size and borough, filter by Borough and Category, search with text.
  • Browse all Capital Projects of a specific agency, sort, filter and search them.
  • View an individual Capital Project Profile, its profile info, changes over time and timeline.