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

Searches a specific pressroom for tagged press releases

Supported Formats

json

Errors

Code Description
404 Missing
422 One or more of the tags specified did not exist

Examples

GET /v1/pressrooms/1009/search.json?tags=Mars&match=any
200
{
  "data": [
    {
      "id": 35,
      "pressroom_id": 1009,
      "title": "Test Pressroom",
      "subtitle": null,
      "release_date": null,
      "release_location": null,
      "language": "en",
      "social_media_pitch": null,
      "summary": null,
      "body_html": "<p>Officia eius blanditiis consequatur reiciendis consectetur. Vitae sapiente accusantium ut totam nesciunt molestias repellendus enim. Natus dolor reprehenderit odit consequatur ipsa eos. Asperiores non quod laboriosam aut enim non. Esse quia et animi impedit excepturi quia nisi. Voluptas eos et corrupti voluptas quae. Rerum aperiam expedita tempore enim magni quae libero. Consequatur qui veniam esse. Libero sed qui omnis. Qui doloremque nostrum eligendi. Quibusdam necessitatibus qui qui eum perferendis earum velit dolorem. Similique autem nulla exercitationem at numquam ipsa minus porro. Harum non porro ea qui fuga repellendus. Et aut et ullam quia. Est laudantium voluptatibus aspernatur ducimus quam repellendus molestias. Dolorem esse iusto reprehenderit harum quia ipsam assumenda molestiae. Rem dignissimos aliquam mollitia sit quas culpa beatae natus.</p>",
      "permalink": "/35-test-pressroom",
      "type": "press_release",
      "state": "published",
      "short_link": "https://pr.co/p/",
      "pdf": null,
      "show_in_timeline": true,
      "content_as_json": null,
      "draft_content_as_json": null,
      "freeform_two": false
    }
  ],
  "paging": {
    "page": 0,
    "limit": 10,
    "total": 10
  }
}

Params

Param name Description
id
required

Pressroom id or pressroom domain

Validations:

  • Must be a String

includes
optional

Include attachments. To include featured images use: featured_images.

Validations:

  • Must be a String

tags
optional

Finds press releases with these tags

Validations:

  • Must be a String

match
optional

Match all tags provided, or match any tags provided (defaults to any)

Validations:

  • Must be a String

language
optional

Search only this language

Validations:

  • Must be a String

limit
optional

Limit number of press releases returned, defaults to 30

Validations:

  • Must be a String