OpenPublica← The Record
▸ Contents
The Developer Wire● Free · No key

API Reference

The Open Publica API is free and needs no key. It powers this site: search covered US local-government records, read available summaries and transcripts, and find governments near a place. REST data routes use GET; the assembled plan returns markdown.

Your first request
curl 'https://api.openpublica.com/v1/meetings?limit=1'

Conventions

Envelope

JSON data routes return { data, meta }. The assembled-plan route returns raw markdown; /v1/openapi.json returns the OpenAPI schema.

Discovery

GET /v1 returns the route index.

Dates & times

start_date and end_date are ISO YYYY-MM-DD, inclusive. Meetings carry both an ISO date and epoch_timestamp in Unix seconds (UTC).

Coordinates

Coordinates use GeoJSON [longitude, latitude] order, including near and government locations.

Pagination

Offset routes use page (1-based). Content search uses next/previous cursors; metadata traversal uses next_cursor. Follow has_more, including on short or empty visible cursor pages.

Lists

The gateway comma-joins repeated query keys, so only government_ids, fields, and near are parsed as comma-separated lists.

Compression

Send Accept-Encoding: gzip to compress responses over about 1 KB.

Sparse fields

On /v1/meetings, fields selects public field names and reduces payloads. Metadata cursor mode requires its exact five-field set; other fields use offset pagination.

Errors

Failures return their HTTP status and {"error": {"message": "..."}}. Missing entities return 404.

400
Bad request

A parameter is missing or malformed: no q on search, a non-ISO date, or more than one government selector.

404
Not found

Unknown meeting or government id, an unresolvable postal code, or a route that doesn't exist.

405
Method not allowed

v1 is GET-only. The response carries Allow: GET.

409
Search changed

A cursor no longer matches the query or scope. Restart the search.

410
Retired route or mode

Keyword/hybrid summary search and the older transcript-search routes are retired. Use /v1/meetings/content-search.

429
Too many requests

Throttled. The response carries Retry-After. Wait that many seconds before retrying.

500
Server error

Something failed on our side. Retry with backoff.

The meeting object

Fields vary by record and route. Semantic search adds a relevance score; content search adds match information. Sparse listings return only selected fields.

Attributes
meeting_id
string

Canonical id. The only value the meeting routes accept.

government_id
string

The government this meeting belongs to.

title
string

Meeting title as filed.

date
string

Meeting date, ISO YYYY-MM-DD (UTC).

epoch_timestamp
integer

The same moment in Unix seconds. Multiply by 1000 for a JS Date.

duration_seconds
number | null

Measured duration in seconds when available. Legacy records may omit it or carry null/zero; do not infer transcript availability from it.

summary
string

AI-generated markdown summary when available. May be empty or based on an agenda; verify outcomes against the official record.

category_name
string

Human-readable meeting body, e.g. "City Council".

category_tag
string

Opaque UUID for that body. It is the value the category_tag filter takes.

topics
array

Objects of { topic, conversation_percentage }, the discussion breakdown.

video_url
string | null

Archived recording. Null until the deferred Internet Archive upload lands.

source_url
string | null

Original source link when available. It may provide playback while video_url is null.

thumbnail_url
string

Thumbnail URL when available; tolerate a missing or inaccessible image.

transcript_url
string | null

Transcript JSON URL when available. A decoded-empty recording can have no transcript; legacy records may omit this field.

relevance_score
number

Semantic match strength. Search results only.

search
object

Content-search matches: matched_fields, transcript_excerpt (currently null), and optional untimed transcript_preview text with Unicode codepoint match offsets.

The government object

Profile fields from government listing and detail routes. A tracked government can be a city, county or district.

Attributes
government_id
string

Canonical id, e.g. "sacramento_county-california".

name
string

Display name, e.g. "Sacramento County, California".

city
string

City or county component of the name, lowercase.

state
string

State component, lowercase.

location
object

GeoJSON point: { type, coordinates: [longitude, latitude] }.

categories
array

Tracked meeting bodies: { name, tag, data_source, playlist_url }.

topics
array

Topic names seen across this government's meetings.

imageUrl
string

Government seal or icon. Note the camelCase, which predates the v1 renames.

weekly_summary
string

Stored markdown digest, when available and requested with include_weekly_summary=true. Retrieval does not regenerate it.

The document object

Returned by the document routes. A document is one adopted publication (a general-plan element, a bound plan, or a budget) pinned to the government that adopted it. Which fields appear depends on status, so read that first.

Attributes
id
string

Document id, which is what the /v1/documents routes take. Search results spell it document_id.

government_id
string

The government that published it.

title
string

The document's own title, as published.

status
string

What this entry offers: converted, superseded, or failed. See below.

covers
array

Every plan slot this document answers for. A bound plan expands to all eight elements.

source_url
string

The government's own copy. Always present, including on a failed entry; cite it.

verified_on
string

Date we last confirmed the pin points at this document.

checked_at
string

Date we last looked at it.

page_count
integer

Pages in the source PDF. Absent on a failed document.

doc_type
string

Only on documents that carry one (budgets and the like); absent on general-plan elements.

availability
object

Present when a document has findings: complete, reason and problems.

superseded_by
string

The edition that retired this one. Only on a superseded document.

markdown_url
string

The whole document as markdown. Only on GET /v1/documents/{id}.

Meetings

List meetings

GET/v1/meetings

Returns public meeting records, newest first. Scope to one government with government_id, or omit it for the corpus. Available summaries, transcripts and media vary by record.

Start metadata traversal with cursor=start, limit=1000 and exactly these comma-separated fields: meeting_id, government_id, category_name, epoch_timestamp, last_updated. Omit all filters and page. Results sort by epoch_timestamp, then meeting_id, both descending. Follow meta.has_more and meta.next_cursor through short or empty visible batches; the cursor is not a snapshot.

Parameters
government_id
string

Scope to one government, e.g. "sacramento_county-california".

category_tag
string

Filter to one meeting body. An opaque UUID: read it from /v1/vocabulary rather than guessing.

topic
string

Only meetings that discussed this topic, e.g. "Affordable Housing".

start_date
string

Earliest meeting date, ISO YYYY-MM-DD (inclusive).

end_date
string

Latest meeting date, ISO YYYY-MM-DD (inclusive).

limit
integer

Results per offset page, 1–100 (default 10). Metadata cursor batches allow up to 1000.

page
integer

1-based offset page, 1–1000 (default 1), with skip capped at 50,000 rows. Do not combine with cursor.

fields
string

Comma-separated public field names. Records include only requested fields; stored spellings such as _id and account_id are rejected.

cursor
string

Metadata traversal only: start, then meta.next_cursor unchanged. Requires the exact five fields described below and no filters or page.

curl 'https://api.openpublica.com/v1/meetings?government_id=bellevue-washington&limit=5'
Example response
{
  "data": [
    {
      "meeting_id": "6a5b0a986b2c35938e9a89aa",
      "government_id": "bellevue-washington",
      "title": "Bellevue City Council Meeting - July 17, 2026",
      "date": "2026-07-17",
      "epoch_timestamp": 1784313900,
      "duration_seconds": 5302.72,
      "category_name": "City Council",
      "category_tag": "c125a28d-4898-4276-ac9c-21050c767352",
      "summary": "# Bellevue City Council Meeting...",
      "video_url": "https://archive.org/download/.../meeting.mp4",
      "source_url": "https://bellevue.granicus.com/...",
      "thumbnail_url": "https://.../thumbnails/31127b60.webp",
      "transcript_url": "https://.../transcriptions/31127b60.json",
      "topics": [
        { "topic": "Economic Development", "conversation_percentage": 29 }
      ]
    }
  ],
  "meta": { "count": 1, "limit": 5, "page": 1, "has_more": true }
}

Search meeting content

GET/v1/meetings/content-search

Search titles, summaries, topics and stored transcripts in one ranked list, with each meeting appearing once. Coverage varies; a missing match does not prove a topic was never discussed.

search.transcript_excerpt is null. Optional transcript_preview contains current text and Unicode codepoint match offsets, without verified timing. A transcript match can have no preview. Cursors are live, not snapshots; keep query, filters and limit unchanged.

Parameters
q
stringRequired

1–160 characters. Whole double quotes request an analyzed phrase; punctuation is not byte-exact.

source
string

all (default), metadata, or transcripts.

match_mode
string

phrase matches analyzed words in order; all_words requires every term within one selected field. Omit for any-word matching or whole-query quote syntax.

government_id
string

Scope to one government. Mutually exclusive with government_ids.

government_ids
string

Comma-separated list of 1–100 government ids; do not combine with government_id.

meeting_id
string

Scope to one canonical 24-character lowercase meeting id.

body_id
string

Exact meeting-body identifier.

topic
string

Exact meeting-topic filter.

start_date
string

First included UTC date, YYYY-MM-DD.

end_date
string

Last included UTC date, YYYY-MM-DD.

limit
integer

Meetings per page, 1–20. Defaults to 10.

cursor
string

Use next_cursor or previous_cursor unchanged. Restart after query or scope changes. No total is returned.

curl 'https://api.openpublica.com/v1/meetings/content-search?q=affordable+housing&match_mode=all_words&source=all&limit=5'
Example response
{
  "data": [{
    "meeting_id": "6a5ba563566bda5aeed771be",
    "government_id": "san_antonio-texas",
    "title": "Affordable Housing Public Hearing",
    "epoch_timestamp": 1776211200,
    "summary": "The council reviewed housing policy.",
    "topics": [],
    "search": {
      "matched_fields": ["title", "summary"],
      "transcript_excerpt": null, "transcript_preview": null
    }
  }],
  "meta": {
    "schema_version": "meeting-content-search.v1",
    "next_cursor": null, "previous_cursor": null,
    "has_more": false, "order": "relevance",
    "coverage": {
      "searched_fields": ["title", "summary", "topics.topic", "transcripts"],
      "transcripts": "stored-text", "timed_evidence": "partial",
      "recording_completeness": "unknown"
    }
  }
}

Search summaries by meaning

GET/v1/meetings/search

Semantic retrieval over AI meeting summaries. Use content-search for stored words and transcript text. Keyword and hybrid modes are retired and return 410.

Ranks up to 60 results. meta.has_more applies within that window; window_full does not establish complete coverage. Results and ordering can change between requests.

Parameters
q
stringRequired

Nonempty natural-language query, up to 2000 characters.

mode
string

semantic only (the default).

government_id
string

Scope to one government.

government_ids
string

Comma-separated list of up to 50 government ids. Takes precedence over government_id.

category_tag
string

Exact body identifier from /v1/vocabulary.

topic
string

Exact topic filter.

start_date
string

First included UTC date, YYYY-MM-DD.

end_date
string

Last included UTC date, YYYY-MM-DD.

min_score
number

Semantic relevance floor, 0–1 (default 0.4).

limit
integer

Results per page, 1–25 (default 10).

page
integer

1-based page whose first result lies within the 60-result window.

curl 'https://api.openpublica.com/v1/meetings/search?q=short-term+rental+regulations&mode=semantic&limit=5'
Example response
{
  "data": [{
    "meeting_id": "6a5ba563566bda5aeed771be",
    "government_id": "san_antonio-texas",
    "title": "City Council Meeting",
    "summary": "The council discussed short-term rental rules.",
    "relevance_score": 0.82
  }],
  "meta": {
    "count": 1, "limit": 5, "page": 1,
    "has_more": false, "result_window": 60, "window_full": false,
    "match_type": "semantic"
  }
}

Retrieve a meeting

GET/v1/meetings/{id}

Returns one public meeting record, including available summary, topics and transcript_url. Fields can be absent, empty or null; a decoded-empty recording can have no transcript or summary. Unknown or unavailable public records respond 404.

Parameters
id
string · pathRequired

The meeting_id from a list or search result.

curl 'https://api.openpublica.com/v1/meetings/6a5b0a986b2c35938e9a89aa'
Example response
{
  "data": {
    "meeting_id": "6a5b0a986b2c35938e9a89aa",
    "government_id": "bellevue-washington",
    "title": "Bellevue City Council Meeting - July 17, 2026",
    "date": "2026-07-17",
    "epoch_timestamp": 1784313900,
    "duration_seconds": 5302.72,
    "category_name": "City Council",
    "summary": "# Bellevue City Council Meeting...",
    "video_url": "https://archive.org/download/.../meeting.mp4",
    "source_url": "https://bellevue.granicus.com/...",
    "transcript_url": "https://.../transcriptions/31127b60.json",
    "topics": [
      { "topic": "Historic Preservation", "conversation_percentage": 14 }
    ]
  },
  "meta": {}
}
Governments

Find governments

GET/v1/governments

Find tracked governments by name (q), coordinate (near) or ZIP (postal_code). Pass at most one selector; omit all for an alphabetical page. meta.mode identifies the selector.

Parameters
q
string

Name search, e.g. "sacramento" or "texas".

near
string

"lon,lat" in GeoJSON order, longitude first, e.g. -121.49,38.58.

postal_code
string

ZIP to geocode and search around. Unknown ZIP responds 404.

country_code
string

ISO country code for postal_code. Defaults to "US".

limit
integer

Max results, 1–50. Defaults to 10.

page
integer

1-based page index, 1–1000. Name and alphabetical modes only.

include_latest_meeting
boolean

Name and alphabetical modes only: true adds latest_meeting_epoch_timestamp for each government, when available. Defaults to false.

curl 'https://api.openpublica.com/v1/governments?postal_code=95814'
Example response
{
  "data": [
    {
      "government_id": "sacramento_county-california",
      "name": "Sacramento County, California",
      "city": "sacramento county",
      "state": "california",
      "location": { "type": "Point", "coordinates": [-121.4418, 38.5692] },
      "categories": [
        {
          "name": "Board of Supervisors",
          "tag": "7e36f7b9-9156-42ba-a65b-7af71221626d",
          "data_source": "youtube"
        }
      ],
      "topics": ["Homelessness", "Affordable Housing"]
    }
  ],
  "meta": {
    "mode": "postal",
    "resolved_location": {
      "postal_code": "95814",
      "place_name": "Sacramento",
      "state_name": "California",
      "coordinates": [-121.4944, 38.5816]
    },
    "count": 1,
    "limit": 10
  }
}

Retrieve a government

GET/v1/governments/{id}

Returns one government's profile and tracked meeting bodies. Use include_weekly_summary to request its stored AI digest, when available; check the period covered in its content. Responds 404 if the id is unknown.

Parameters
id
string · pathRequired

The government_id to look up.

include_weekly_summary
boolean

Pass true to include a stored markdown digest if present. This does not generate or refresh it.

curl 'https://api.openpublica.com/v1/governments/sacramento_county-california?include_weekly_summary=true'
Example response
{
  "data": {
    "government_id": "sacramento_county-california",
    "name": "Sacramento County, California",
    "city": "sacramento county",
    "state": "california",
    "location": { "type": "Point", "coordinates": [-121.4418, 38.5692] },
    "weekly_summary": "## This week\nThe board approved..."
  },
  "meta": {}
}

Retrieve activity stats

GET/v1/governments/{id}/stats

Returns a meeting-activity rollup over a recent window: the total, a per-day histogram, and the most active meeting bodies. Pass "all" as the id for corpus-wide numbers.

Parameters
id
string · pathRequired

A government_id, or "all" for every government.

days
integer

Look-back window in days, 1–365. Defaults to 30.

curl 'https://api.openpublica.com/v1/governments/all/stats?days=7'
Example response
{
  "data": {
    "government_id": "all",
    "total_meetings": 196,
    "activity_by_day": { "2026-07-13": 24, "2026-07-14": 68 },
    "categories": [
      {
        "name": "City Council",
        "count": 103,
        "tags": ["c125a28d-4898-4276-ac9c-21050c767352"]
      }
    ]
  },
  "meta": { "days": 7 }
}
Documents

Status & coverage

Adopted plans and budgets are page-cited text. Read document status and government coverage separately.

status: what one document offers
converted
Served

Currently served: searchable, and readable by page range.

superseded
Retired

Replaced by a newer edition. Still stored and listable with include_superseded, but neither searchable nor readable.

failed
Unreadable

We hold this pin and could not read the document. It does NOT mean the government published nothing. source_url still points at the city's own copy.

meta.coverage.state: whether we have looked at all
pinned
Documents pinned

We have pinned documents here. coverage.pinned_slots names which slots were looked for, which is not everything a city publishes.

reviewed_none_pinned
Looked, found none

We reviewed this government and pinned nothing.

unavailable
Could not review

Review was not possible; coverage.reason says why.

not_reviewed
Not looked at yet

We have not reviewed this government. Empty data is a fact about OpenPublica's coverage rather than what the government publishes.

null
No row yet

The government was added since the coverage projection last ran. Not the same claim as not_reviewed, so don't collapse the two.

An empty data list does not prove a government publishes nothing. Read meta.coverage.state for the scope of our review.

covers, not element

A combined general-plan PDF covers all eight elements. Use covers for every slot a document answers for; search hits' element names only the pin that acquired it.

List a government's documents

GET/v1/governments/{id}/documents

The adopted general-plan and budget documents held for one government. Read meta.coverage alongside data: an empty list can mean the government has not been reviewed, rather than that it publishes nothing.

Parameters
id
string · pathRequired

The government_id to list documents for.

include_superseded
boolean

Pass true to include editions retired by a newer one. Defaults to false.

limit
integer

Max documents, 1–50 (also the default).

curl 'https://api.openpublica.com/v1/governments/san_antonio-texas/documents'
Example response
{
  "data": [
    {
      "id": "9ad60b2d997f9c06b136ccfba64f3e2466589d59c22b3d66d2c7a9800a208186",
      "government_id": "san_antonio-texas",
      "title": "SA Tomorrow Comprehensive Plan (Adopted August 11, 2016)",
      "status": "converted",
      "covers": [
        "circulation", "combined", "conservation", "ej", "housing",
        "land_use", "noise", "open_space", "safety"
      ],
      "source_url": "https://sacompplan.com/new_docs/SA_CompPlan_FULLDoc.pdf",
      "verified_on": "2026-08-17",
      "checked_at": "2026-08-18",
      "page_count": 330
    }
  ],
  "meta": {
    "count": 1,
    "limit": 50,
    "coverage": {
      "state": "pinned",
      "pinned_slots": ["combined"],
      "seed_url": "https://sacompplan.com/",
      "reason": null,
      "last_reviewed": "2026-08-17"
    }
  }
}

Download the assembled general plan

GET/v1/governments/{id}/plan

Every served general-plan document for a government, assembled into one markdown file. Some cities bind their plan into a single PDF and others split it across eight, so this normalises them. Asking for "the general plan" does not require knowing which kind of city you have. Sections run in the order a plan is conventionally bound (Gov Code §65302), not alphabetically. Budgets are excluded.

Returns raw text/markdown, not the { data, meta } envelope, because the point of the route is to hand you a file. It 404s when no plan documents are served. Page anchors survive as <!-- page N --> but are per section, numbering that section's own source PDF.

Parameters
id
string · pathRequired

The government_id whose plan to assemble.

curl 'https://api.openpublica.com/v1/governments/alameda_county-california/plan'
Response · text/markdown
# General plan documents — alameda_county-california

Assembled by OpenPublica from the documents it serves for this
government. Each section below is a separate publication by the
government; page anchors (<!-- page N -->) refer to pages of that
section's own source PDF, linked in its heading.

**Contains 3 documents.**
OpenPublica has pinned these slots for this government: conservation,
ej, open_space. That is what we have looked for, not a statement that
the government publishes nothing else — a plan element absent here may
simply not have been reviewed yet. Last reviewed 2026-08-09.

---

## Conservation — Conservation Element

- Source: https://www.acgov.org/cda/planning/.../Conservation_Element.pdf
- Pages: 104
- Covers: conservation
- **Transcription findings were recorded for this document;** check
  figures against the source.

<!-- page 1 -->
# CONSERVATION ELEMENT
## OF THE
# ALAMEDA COUNTY GENERAL PLAN

Search document text

GET/v1/documents/search

Word search over page-cited chunks of currently-served documents. Each hit is an excerpt with the pages it came from, so it is citable on its own. text is a short passage around the match joined with …, not the whole page window. Read it in context with the page route below.

This is word matching, not semantic search. Unlike /v1/meetings/search there is no embedding behind it. Retired and unreadable documents are not indexed, so an empty result is not evidence the government published nothing; the listing route is what answers that.

Parameters
q
stringRequired

The words to find.

government_id
string

Scope to one government. Omit to search every served document.

limit
integer

Max excerpts, 1–50 (default 10).

curl 'https://api.openpublica.com/v1/documents/search?q=housing+element&limit=2'
Example response
{
  "data": [
    {
      "document_id": "af906437578898f5447d3df23da1cf8d46607c548b98e2…",
      "government_id": "miami_dade_county-florida",
      "document_title": "III. Housing Element",
      "doc_type": null,
      "element": "housing",
      "first_page": 1,
      "last_page": 1,
      "document_complete": true,
      "source_url": "https://www.miamidade.gov/.../cdmp-housing-element.pdf",
      "text": "# HOUSING ELEMENT\n\n## Introduction\n\nThe purpose of the Housing Element is to provide a framework …",
      "score": 2.127356038305101
    }
  ],
  "meta": { "count": 1, "limit": 2 }
}

Retrieve a document

GET/v1/documents/{id}

One document's metadata: a listing entry plus markdown_url. The listing omits that URL because it is a fifth of an entry, and reading pages is what the route below is for.

Parameters
id
string · pathRequired

The document id, from a listing or search result.

curl 'https://api.openpublica.com/v1/documents/b5a2daeca5cc571e2b8867b6f77ac4ffe0c0802874e247b3688dcde9fda282c4'
Example response
{
  "data": {
    "id": "b5a2daeca5cc571e2b8867b6f77ac4ffe0c0802874e247…",
    "government_id": "alameda_county-california",
    "title": "Conservation Element",
    "status": "converted",
    "covers": ["conservation"],
    "source_url": "https://www.acgov.org/.../Conservation_Element_1994.pdf",
    "verified_on": "2026-08-09",
    "checked_at": "2026-08-16",
    "page_count": 104,
    "availability": {
      "complete": false,
      "problems": [
        "5 footnote definition(s) never referenced (a marker may have been merged into a number)"
      ],
      "reason": "this document has transcription findings; any page that could not be read is marked in place in the text"
    },
    "markdown_url": "https://openpublica.s3.us-west-2.amazonaws.com/….md"
  },
  "meta": {}
}

Read document pages

GET/v1/documents/{id}/text

The markdown of one page range. Pages are transcribed from rendered pixels rather than the PDF text layer, so scanned tables come through as text, and a page that could not be transcribed appears as a marked hole rather than a silent omission.

Cite covered, not requested. Text is assembled from the page windows overlapping your range, so covered runs wider when a window overran the range and narrower when the character bound cut it short. The span is clamped to 40 pages and 120k characters rather than rejected, so asking for a whole 300-page plan gives you the start of it, not a 400.

Parameters
id
string · pathRequired

The document id to read.

first_page
integer

First page of the range. Defaults to 1.

last_page
integer

Last page. Defaults to first_page + 39, and is clamped to that span.

curl 'https://api.openpublica.com/v1/documents/b5a2daeca5cc571e2b8867b6f77ac4ffe0c0802874e247b3688dcde9fda282c4/text?first_page=1&last_page=2'
Example response
{
  "data": {
    "document_id": "b5a2daeca5cc571e2b8867b6f77ac4ffe0c080…",
    "government_id": "alameda_county-california",
    "title": "Conservation Element",
    "source_url": "https://www.acgov.org/.../Conservation_Element_1994.pdf",
    "page_count": 104,
    "requested": { "first_page": 1, "last_page": 2 },
    "covered":   { "first_page": 1, "last_page": 6 },
    "markdown": "# CONSERVATION ELEMENT\n## OF THE\n# ALAMEDA COUNTY GENERAL PLAN\n\n| | Volume |…"
  },
  "meta": { "max_page_span": 40 }
}
Discovery

List filter values

GET/v1/vocabulary

Returns the values the category_tag and topic filters accept: meeting bodies mapped to their opaque tag UUIDs, and the most common topic names, each with counts. Read this before filtering, because category_tags cannot be guessed. Without dates it covers a recent window, echoed as meta.default_window_days.

Parameters
government_id
string

Scope to one government. Omit for the whole corpus.

government_ids
string

Comma-separated list of up to 50 government ids. Takes precedence over government_id.

start_date
string

Earliest meeting date, ISO YYYY-MM-DD.

end_date
string

Latest meeting date, ISO YYYY-MM-DD.

limit
integer

Max topics returned, 1–200. Defaults to 50.

curl 'https://api.openpublica.com/v1/vocabulary?government_id=sacramento_county-california'
Example response
{
  "data": {
    "categories": [
      {
        "name": "Boards and Commissions",
        "count": 10,
        "tags": ["4d754a2b-3b8f-4706-9927-527fe66d0fb2"]
      }
    ],
    "topics": [
      { "topic": "Procedural", "count": 14 },
      { "topic": "Budget and Finance", "count": 11 }
    ]
  },
  "meta": { "total_meetings": 15, "default_window_days": 90, "limit": 50 }
}

Retrieve coverage totals

GET/v1/stats

Returns estimated stored-record totals, not publication-filtered coverage. total_states counts states; includes_dc reports DC separately. Counts do not establish completeness, searchability or freshness.

Takes no parameters.

curl 'https://api.openpublica.com/v1/stats'
Illustrative response · use the request for current totals
{
  "data": {
    "total_governments": 2,
    "total_states": 1,
    "includes_dc": false,
    "total_meetings": 12
  },
  "meta": {}
}
MCPThe wire service · ● Live

Put the whole archive on your AI's desk.

Point Claude, Cursor, or any MCP-capable assistant at this read-only Streamable HTTP endpoint to research covered meetings and documents. All 16 tools need no account or key.

Use the server's tools/list response for MCP argument schemas. Content search uses category_tag for the REST body_id filter, and a whole quoted query for phrase matching; it has no match_mode argument.

Tools
find_governments_by_name

Resolve a city or state name to tracked governments.

find_governments_by_zip

Resolve a US ZIP code to nearby governments.

find_local_governments

Find governments near a coordinate.

discover_meeting_vocabulary

List the valid category and topic filter values.

search_meeting_content

Search metadata and stored transcript words once per meeting, with native cursors and optional untimed previews.

search_meetings_semantic

Find AI summaries by meaning; semantic mode only.

list_recent_meetings

Browse a government's meetings, newest first.

get_meeting

Available summary, topics, and optional transcript text.

search_meeting_transcript

Search stored text inside one meeting; optional current-text previews have no timing.

get_government_info

Profile and details for one government.

get_government_stats

Activity stats for a government or the whole corpus.

get_coverage_overview

Corpus totals: governments, states, meetings.

list_government_documents

A government’s adopted plan and budget documents, with its coverage state.

search_documents

Word search across plan and budget text, returning page-cited excerpts.

get_document

One document’s metadata.

read_document_pages

Read a page range of a document as markdown.

Endpoint
https://api.openpublica.com/mcp
mcp.json
{
  "mcpServers": {
    "openpublica": {
      "url": "https://api.openpublica.com/mcp"
    }
  }
}

In Claude web or desktop, add it under Settings → Connectors → Add custom connector.

Assembled plans are REST-only downloads. For bounded, page-cited MCP reads, use search_documents then read_document_pages.

Notes & fair use
  • Archival upload is deferred, so video_url is null until a meeting's recording lands on the Internet Archive, then backfilled. Fall back to source_url when available. Summaries, transcripts, source links and other media can be absent; tolerate empty and null fields.
  • Offered free for public-interest, research, and civic projects. Respect Cache-Control, keep requests bounded, and honor Retry-After with backoff when throttled.
  • Data comes from AI transcription and summarization and may contain errors. The official record is authoritative.
  • Shapes reflect current usage and may evolve. Build defensively and tolerate extra fields.
  • Need a city covered, or a higher-volume use case? Reach out.
Openpublica · Developer Wireopenpublica.com