Opendatanetwork

ODN API

The Socrata OpenDataNetwork (ODN) REST API exposes public data, often continuosly updated and enhanced, from many thousands of public government and non…

Data & analytics#openapi#open-data

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Socrata OpenDataNetwork (ODN) REST API exposes public data, often continuosly updated and enhanced, from many thousands of public
government and non profit agencies.

Much of this data originating from independent sources is fused together to create new, and often
powerful, entity level data. The API, in addition to search and autosuggest capabilities for finding datasets,
enables data based comparisons across geographical regions such as states, counties, metropolitan areas,
cities and zip codes using highly vetted data providers such as US Census, BEA, HUD and others. Comparison data
is preformatted for easy and efficient display on a chart, graph or interactive map.

The API also exposes data organized by narrative style questions a human might ask. The questions can
be rapidly found using an autosuggest style index, and then used to directly access all data needed to
thoroughly and authoritatively answer the question. Retrieved data includes time series (temporally aligned),
tabular, map heavy (includes spatial boundaries), and auto generated unstructured descriptive text.

The ODN API does not duplicate API endpoints or services provided by public sector agencies, but rather,
returns context relevant pre-populated REST URLs, when appropriate, so the caller can access data
directly from the source.

The open source API powers OpenDataNetwork.com, an open source
site; the site highlights myriad uses and provides API badges with contextually relevant API example
REST endpoints and documentation pointers.

Finally, we continuously add new dat sources which appear automatically in the API, so if your favorite data
source is not available, check back soon. You can also join us HERE
and receive updates or let us know which data sources you are most interested in.

App Tokens

Registering for and including a Socrata application token
is _required_ for the ODN API. They can be passed either using the app_token parameter
or the X-App-Token HTTP header.

Endpoints 9

  • GETFind all available data for some entities/data/v1/availability/?entity_id=0100000US,0400000US53&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETGet constraint permutations for entities/data/v1/constraint/:variable?entity_id=0100000US,0400000US53&constraint=year&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETCreate a map/data/v1/map/new?variable=demographics.population.count&entity_id=0400000US53,0400000US08&constraint=string&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETGet values for variables/data/v1/values?variable=demographics.population.count&entity_id=0100000US,0400000US53&forecast=3&describe=false&format=google&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETGet Entities/entity/v1?entity_id=0400000US53&entity_name=washington&entity_type=region.state&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETFind the relatives of an entity/entity/v1/:relation?entity_id=0400000US53&variable_id=demographics.population.seattle&limit=10&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETGet datasets/search/v1/dataset?entity_id=0100000US&dataset_id=demographics.population&limit=10&offset=0.0&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETGet questions/search/v1/question?query=seattle&limit=10&offset=0.0&app_token=cQovpGcdUT1CSzgYk0KPYdAI0
  • GETGet suggestions/suggest/v1/:type?query=seattl&limit=5&variable_id=demographics.population.count&app_token=cQovpGcdUT1CSzgYk0KPYdAI0

API details

Base URL
http://api.opendatanetwork.com
Authentication
None declared in the description
Operations
9 operations on 9 pathsGET 9
Response formats
application/json
Description format
OpenAPI 3.0.0, API version 1.0.0
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the ODN API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the ODN API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Find all available data for some entities” (GET /data/v1/availability/?entity_id=0100000US,0400000US53&app_token=cQovpGcdUT1CSzgYk0KPYdAI0), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the ODN API?

The Socrata OpenDataNetwork (ODN) REST API exposes public data, often continuosly updated and enhanced, from many thousands of public government and non… It is listed under Data & analytics and has 9 endpoints.

Who publishes the ODN API?

It is listed from Opendatanetwork's public API description (an OpenAPI document), not published by Opendatanetwork on Swastik Codes. Anyone who controls opendatanetwork.com can claim the profile by adding a DNS TXT record.

What is the base URL of the ODN API?

Requests go to http://api.opendatanetwork.com. Endpoint paths are added to this base URL.

How do I authenticate with the ODN API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the ODN API have?

9 operations on 9 paths (9 GET).

Is forking the ODN API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.