API reference

Publications

Official documents from the publisher registry: police media releases first, versioned and kept after the publisher deletes them. Base URL https://dataquoll.io/api/v1.

GET/publications

Official documents from the publisher registry

Official documents, newest first: media releases, news, alerts and notices from the publishers in the registry (listPublishers). Today that is South Australia Police media releases, collected continuously since 26 September 2026 and kept after the publisher deletes them. Filter by state, publisher type or source, document kind, a publisher's own section, and a UTC date range; page with the cursor in links.next. Free keys see the last 7 days, from 00:00 UTC seven days back. A since or until outside that window is refused with 403 and counts against quota. Paid plans see the whole archive. A media release follows the event, often by hours or days, and an appeal for information is not a finding of fact. Place and time extracted from the text appear under extract once the extraction pass has run, and are null until then, never guessed. Images are counted in imageCount; whether they are served is set per publisher.

Parameters

Name	In	Required	Type	Description
`state`	query	No	`string`	Jurisdiction code, or a comma list. A jurisdiction with no publisher yet returns an empty list, not an error.
`type`	query	No	`string`	Publisher type, or a comma list: police, fire, ses, ambulance, health, transport, council, union, other.
`source`	query	No	`string`	Publisher id from listPublishers, or a comma list.
`kind`	query	No	`string`	Document kind, or a comma list: media_release, news, alert, notice.
`section`	query	No	`string`	One of the publisher's own sections. For South Australia Police, a district, region or topic such as northern-police-district, traffic or missing-persons.
`since`	query	No	`string`	First UTC date, YYYY-MM-DD, inclusive.
`until`	query	No	`string`	Last UTC date, YYYY-MM-DD, inclusive.
`includeRemoved`	query	No	`boolean`	true to include documents the publisher has since taken down. They stay in the archive with removedAt set. Default false.
`limit`	query	No	`integer`
`cursor`	query	No	`string`	The opaque cursor from links.next.

Responses

Status	Description
`200`	The page of publications
`400`	Unknown state, type, source or kind, a malformed date, section, limit or cursor
`401`	Missing or invalid API key
`403`	A free key asked for dates outside its 7-day window
`429`	Rate limit exceeded

Request

curl "https://dataquoll.io/api/v1/publications?state=sa&type=police" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "publications": [
    {
      "id": "83c37297-3803-404c-babd-02225d57372e",
      "source": "sa-police",
      "publisher": {
        "name": "South Australia Police",
        "agency": "SAPOL",
        "type": "police",
        "jurisdiction": "sa"
      },
      "kind": "media_release",
      "slug": "dashcam-sought-after-eudunda-road-rage",
      "title": "Dashcam sought after Eudunda road rage",
      "summary": "Police are seeking witnesses and dashcam footage following a road rage incident at Eudunda.",
      "publishedAt": "2026-09-26T00:26:36+00:00",
      "modifiedAt": "2026-09-26T00:26:54+00:00",
      "sections": [
        "barossa-region",
        "more-news",
        "rss-news",
        "yorke-mid-north-region"
      ],
      "url": "https://www.police.sa.gov.au/sa-police-news-assets/front-page-news/dashcam-sought-after-eudunda-road-rage",
      "versionCount": 1,
      "removedAt": null,
      "attributes": {
        "crimeStoppersRef": "251098",
        "metaTopstory": "no"
      },
      "extract": null,
      "imageCount": 0
    }
  ],
  "meta": {
    "generatedAt": "2026-09-27T03:00:00.000Z",
    "count": 1,
    "depthDays": null
  },
  "links": {
    "next": null
  },
  "attribution": "https://dataquoll.io/api/v1/attribution"
}

GET/publications/{id}

One publication in full

One publication in full: the text body, every path it was published under, and its version list. Publishers edit releases in place and every edit is kept as a new version; the current version is returned unless version is given. images is null while the publisher's images are withheld (South Australia Police images are withheld pending legal advice on identifiable people) and for a document the publisher has taken down (removedAt set); otherwise a list of one-hour signed URLs. Free keys can read publications from the last 7 days.

Parameters

Name	In	Required	Type	Description
`id`	path	Yes	`string`	Publication id (a UUID) from listPublications.
`version`	query	No	`integer`	A version number from the version list. Default the current version.

Responses

Status	Description
`200`	The publication
`400`	The id is not a UUID, or version is not a positive integer
`401`	Missing or invalid API key
`403`	A free key asked for a publication older than its 7-day window
`404`	No publication with that id, or no such version
`429`	Rate limit exceeded

Request

curl "https://dataquoll.io/api/v1/publications/83c37297-3803-404c-babd-02225d57372e?version=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "publication": {
    "id": "83c37297-3803-404c-babd-02225d57372e",
    "source": "sa-police",
    "publisher": {
      "name": "South Australia Police",
      "agency": "SAPOL",
      "type": "police",
      "jurisdiction": "sa"
    },
    "kind": "media_release",
    "slug": "dashcam-sought-after-eudunda-road-rage",
    "title": "Dashcam sought after Eudunda road rage",
    "summary": "Police are seeking witnesses and dashcam footage following a road rage incident at Eudunda.",
    "publishedAt": "2026-09-26T00:26:36+00:00",
    "modifiedAt": "2026-09-26T00:26:54+00:00",
    "sections": [
      "barossa-region",
      "more-news",
      "rss-news",
      "yorke-mid-north-region"
    ],
    "url": "https://www.police.sa.gov.au/sa-police-news-assets/front-page-news/dashcam-sought-after-eudunda-road-rage",
    "versionCount": 1,
    "removedAt": null,
    "attributes": {
      "crimeStoppersRef": "251098",
      "metaTopstory": "no"
    },
    "extract": null,
    "imageCount": 0,
    "version": 1,
    "body": "Police are seeking witnesses and dashcam footage following a road rage incident at Eudunda...",
    "paths": [
      "/sa-police-news-assets/barossa-region/dashcam-sought-after-eudunda-road-rage",
      "/sa-police-news-assets/front-page-news/dashcam-sought-after-eudunda-road-rage",
      "/sa-police-news-assets/yorke-mid-north-region/dashcam-sought-after-eudunda-road-rage"
    ],
    "versions": [
      {
        "versionNo": 1,
        "modifiedAt": "2026-09-26T00:26:54+00:00",
        "title": "Dashcam sought after Eudunda road rage"
      }
    ],
    "images": null
  },
  "meta": {
    "generatedAt": "2026-09-27T03:00:00.000Z"
  },
  "attribution": "https://dataquoll.io/api/v1/attribution"
}

GET/publishers

Publishers of official documents

Every publisher of official documents on the platform: its jurisdiction and type, licence and required attribution, the document kinds it publishes, whether its images are served, the publisher-specific fields its documents carry in attributes and what each means, and live counts. A new publisher appears here the day it is added.

Parameters

Name	In	Required	Type	Description
`state`	query	No	`string`	Jurisdiction code, or a comma list.
`type`	query	No	`string`	Publisher type, or a comma list.
`source`	query	No	`string`	Publisher id, or a comma list.

Responses

Status	Description
`200`	The publishers
`400`	Unknown state, type or source
`401`	Missing or invalid API key
`429`	Rate limit exceeded

Request

curl "https://dataquoll.io/api/v1/publishers?state=sa&type=police" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "publishers": [
    {
      "id": "sa-police",
      "name": "South Australia Police",
      "agency": "SAPOL",
      "type": "police",
      "jurisdiction": "sa",
      "homeUrl": "https://www.police.sa.gov.au",
      "licence": "CC BY 4.0",
      "licenceUrl": "https://creativecommons.org/licenses/by/4.0/",
      "attribution": "Contains SA Police media releases, (c) South Australia Police, used under CC BY 4.0.",
      "commercialUse": true,
      "kinds": [
        "media_release"
      ],
      "serveImages": false,
      "attributes": {
        "crimeStoppersRef": "The Crime Stoppers reference an appeal asks readers to quote, when the release carries one."
      },
      "collection": {
        "kind": "scrape",
        "cadence": "Front-page lists every 5 minutes, district, region and topic sections every 20."
      },
      "status": "active",
      "publications": {
        "total": 498,
        "live": 498,
        "latestPublishedAt": "2026-09-27T02:01:36+00:00"
      },
      "lastCollectedAt": "2026-09-27T03:10:00+00:00"
    }
  ],
  "meta": {
    "generatedAt": "2026-09-27T03:00:00.000Z",
    "count": 1
  },
  "attribution": "https://dataquoll.io/api/v1/attribution"
}