GET
/v1/papers/searchNo key neededSearch the words inside every paper: officer reports, minutes, agendas and appendices. It answers without a key, at 60 requests an hour from one address.
Parameters
| Name | Type | Default | What it is |
|---|---|---|---|
q | text | The words, a "phrase", -leave out, this OR that (required) | |
council | council slug | A council slug | |
type | one of: report, minutes, agenda, appendix, other | Only one kind of paper | |
years | one of: 1, 2, 5, all | all | How far back |
sort | one of: best, newest | best | Best match or newest first |
page | whole number | 1 | Page number, from 1 |
per_page | whole number | 25 | Results per page, at most 100 |
cursor | text | The next_cursor from the previous answer; faster than page for walking far |
Any other parameter is refused with unknown_parameter, naming the ones this endpoint takes.
Request
curl "https://api.councilmonitor.co.uk/v1/papers/search?q=housing&council=argyll-and-bute&per_page=1"
import requests
r = requests.get("https://api.councilmonitor.co.uk/v1/papers/search?q=housing&council=argyll-and-bute&per_page=1")
print(r.json())
const r = await fetch("https://api.councilmonitor.co.uk/v1/papers/search?q=housing&council=argyll-and-bute&per_page=1");
console.log(await r.json());
Answer
200 OKA real answer from today's archive, shortened for this page: lists show their first few and long text its opening.
{
"data": [
{
"id": "pp_7e9b95j6",
"title": "CommunitiesScotlandInvestmentProg0708ANNEX, 05/07/2007 Pre-Agenda Briefing of the Executive",
"kind": "appendix",
"pages": null,
"text": "read",
"link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2007-07-19-executive/papers/70042bbc3d6b/communitiesscotlandinvestmentprog0708annex-05-07-2007-pre-agenda-briefing-of-the.pdf",
"official_url": "https://www.argyll-bute.gov.uk/moderngov/documents/s29688/CommunitiesScotlandInvestmentProg0708ANNEX%2005072007%20Pre-Agenda%20Briefing%20of%20the%20Executive.pdf",
"council": {
"slug": "argyll-and-bute",
"name": "Argyll and Bute"
},
"committee": "Executive",
"date": "2007-07-19",
"meeting": "mt_ea6t00yh",
"quote": "...Fyne Homes Ballochgoy, Rothesay £0.900m Provision of 24 Regeneration of Ballochgoy «Housing» Estate,\n general needs «houses» Rothesay including environmental improvements.\n for..."
}
],
"meta": {
"count": 1,
"next_cursor": "eyJvIjoxfQ",
"page": 1,
"per_page": 1,
"total": 9770,
"total_pages": 9770,
"next_page": 2,
"prev_page": null,
"total_is_at_least": false
}
}Run it live
Press Send to call the API from your browser.