Newsroom API Documentation
Everything you need to integrate pr.co into your website or app.

The pr.co API is organized around REST. This is to make sure the API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate any API errors. We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret API key in any public website's client-side code). JSON is returned by all API responses, including errors, although our API librariesconvert responses to appropriate language-specific objects.

Please note that all API endpoints are read-only and only to be used for building custom solutions: an integration with your own site, a feed of latest news on your homepage or app, direct integrations with internal tools, etc. There is no open API for the creation or modification of content in pr.co, that is only available through pr.co’s management console.

Our documentation is only a mostly-automated overview of the endpoints and their supported parameters. If you have any questions or trouble integrating with the API you can contact regular pr.co support (hello@pr.co) and we will get back with you as soon as we can.

Resources

Clippings
Clippings are articles written about you.

Resource Description
GET /v1/pressrooms/:pressroom_id/clippings.json
GET /v1/pressrooms/:pressroom_id/clippings/:id.json

Documents
Documents

Resource Description
GET /v1/pressrooms/:pressroom_id/documents.json
GET /v1/pressrooms/:pressroom_id/documents/:id.json

Images
Images

Resource Description
GET /v1/pressrooms/:pressroom_id/images.json
GET /v1/pressrooms/:pressroom_id/images/:id.json

Media kit categories
Retrieve one or multiple media kit (formerly presskit) categories

Resource Description
GET /v1/pressrooms/:pressroom_id/media_kit_categories.json
GET /v1/pressrooms/:pressroom_id/media_kit_categories/tree.json
GET /v1/pressrooms/:pressroom_id/media_kit_categories/:id.json

Media kits
Retrieve one or multiple media kits (this resource was previously called presskits)

Resource Description
GET /v1/pressrooms/:pressroom_id/media_kits.json
GET /v1/pressrooms/:pressroom_id/media_kits/:id.json

Pr contacts
Pr Contact

Resource Description
GET /v1/pressrooms/:pressroom_id/pr_contacts/:id.json
GET /v1/pressrooms/:pressroom_id/pr_contacts.json

Press releases
Retrieve one or multiple press releases from the API

Resource Description
GET /v1/pressrooms/:pressroom_id/press_releases.json
GET /v1/pressrooms/:pressroom_id/press_releases/:id.json

Pressrooms
Retrieve a pressroom or it's contents

Resource Description
GET /v1/pressrooms/:id.json
GET /v1/pressrooms/:id/timeline.json
GET /v1/pressrooms/:id/search.json
GET /v1/pressrooms/:id/search_releases.json

Sounds
Sounds

Resource Description
GET /v1/pressrooms/:pressroom_id/sounds.json
GET /v1/pressrooms/:pressroom_id/sounds/:id.json

Tags
Tags

Resource Description
GET /v1/pressrooms/:pressroom_id/tags.json

Videos
Videos

Resource Description
GET /v1/pressrooms/:pressroom_id/videos.json
GET /v1/pressrooms/:pressroom_id/videos/:id.json