Skip to main content
KungoraKungora

API for developers

Read published press releases, news, events and images from Kungora in your own systems, or publish to your newsroom from them.

Published content, no key needed

Newsrooms, stories, search, stories by organisation number and the taxonomies are open: JSON over HTTPS, cursor paging, weak ETags for conditional requests and CORS for every origin. Without a key you may make 60 requests a minute per network.

With an API key

The administrators of an organisation create keys on its API keys page, after signing in. A key raises the limit to 600 requests a minute and, with the write scope, creates drafts, publishes, uploads media and signs up followers with double opt-in. Send it as Authorization: Bearer, from your servers only.

Webhooks

Get a signed POST when one of your stories is published, updated, unpublished or deleted. Administrators add endpoints on the organisation's Webhooks page. The messages follow Standard Webhooks, and a failed delivery is retried for about three days.

Terms and personal data

What you fetch stays the publisher's: when you republish a story, name the newsroom and Kungora as the source, link to the story, and follow each image's licence and credit. Press contacts' names and work details are there for press enquiries about the story only: never use them for marketing, mailing lists or profiling, and never build a register of them. When a story answers 410 or 404, delete your copy and the personal data in it. The terms of use apply.

Terms of use

Documentation