ODN API
opendatanetwork · Data
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
Authentication
Sample Requests
Get Entities
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/entity/v1?app_token=example&entity_id=example&entity_name=example&entity_type=example"
import requests
params = {
"app_token": "example",
"entity_id": "example",
"entity_name": "example",
"entity_type": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/entity/v1",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/entity/v1');
url.searchParams.set('app_token', 'example');
url.searchParams.set('entity_id', 'example');
url.searchParams.set('entity_name', 'example');
url.searchParams.set('entity_type', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/entity/v1")
q := baseURL.Query()
q.Set("app_token", "example")
q.Set("entity_id", "example")
q.Set("entity_name", "example")
q.Set("entity_type", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/entity/v1")
uri.query = URI.encode_www_form({
"app_token" => "example",
"entity_id" => "example",
"entity_name" => "example",
"entity_type" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/entity/v1?" . http_build_query([
"app_token" => "example",
"entity_id" => "example",
"entity_name" => "example",
"entity_type" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Find all available data for some entities
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/availability/?app_token=example&entity_id=example"
import requests
params = {
"app_token": "example",
"entity_id": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/availability/",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/availability/');
url.searchParams.set('app_token', 'example');
url.searchParams.set('entity_id', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/availability/")
q := baseURL.Query()
q.Set("app_token", "example")
q.Set("entity_id", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/availability/")
uri.query = URI.encode_www_form({
"app_token" => "example",
"entity_id" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/availability/?" . http_build_query([
"app_token" => "example",
"entity_id" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Get values for variables
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/values?format=google&describe=true&forecast=1&variable=example&app_token=example&entity_id=example"
import requests
params = {
"format": "google",
"describe": "true",
"forecast": "1",
"variable": "example",
"app_token": "example",
"entity_id": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/values",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/values');
url.searchParams.set('format', 'google');
url.searchParams.set('describe', 'true');
url.searchParams.set('forecast', '1');
url.searchParams.set('variable', 'example');
url.searchParams.set('app_token', 'example');
url.searchParams.set('entity_id', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/values")
q := baseURL.Query()
q.Set("format", "google")
q.Set("describe", "true")
q.Set("forecast", "1")
q.Set("variable", "example")
q.Set("app_token", "example")
q.Set("entity_id", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/values")
uri.query = URI.encode_www_form({
"format" => "google",
"describe" => "true",
"forecast" => "1",
"variable" => "example",
"app_token" => "example",
"entity_id" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/opendatanetwork.com/1.0.0/data/v1/values?" . http_build_query([
"format" => "google",
"describe" => "true",
"forecast" => "1",
"variable" => "example",
"app_token" => "example",
"entity_id" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with ODN API?
ODN API is a Data API. Developers commonly use data APIs for:
- enriching your app with third-party datasets
- building data pipelines and ETL workflows
- querying and searching large datasets
- powering research, analysis, and reporting tools
- syncing reference data into your own systems
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. ODN API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?