Granicus Search API - Introduction
Description and Capabilities
The Granicus Search API allows you to query any marker or video from the entire Granicus library, spanning nearly 1,000 government agencies and including over 2 million individual topics or discussions representing over 100 years of total archived video. The API is roughly modeled after the Elastic Search API, which is documented here.
The API currently does not require any API key. This may change in the future if usage or abuse begins to cause problems. Please be mindful of the performance of your queries, and try not to run expensive ones too often. If too many expensive queries are run, we will have to institute API keys and throttling. Keys and throttling are a pain. They get in the way of making cool things. We like cool things. Please don't ruin it for everyone by being selfish about resources.
60 Second Quick Start
The API currently only exposes a single endpoint which can be used for searching:
You can also search an individual index, for instance for a city, by using:
The easiest searches are done by simply adding ?q=<query> and performing a get. The query can be anything that you would type into the Granicus Search UI. An example search can be performed simply by visiting
which returns results for the search term "budget". You can further refine that search to only markers by adding a type field: