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

Clippings
Clippings are articles written about you.

Supported Formats

json
>>>

GET /v1/pressrooms/:pressroom_id/clippings.json

Retrieves a list of clippings for a specific pressroom

Supported Formats

json

Errors

Code Description
404 Missing

Examples

GET /v1/pressrooms/1000/clippings.json
200
{
  "data": [
    {
      "id": 1,
      "pressroom_id": 1000,
      "press_release_id": null,
      "title": "Example clipping",
      "source": "thenextweb.com",
      "url": "http://thenextweb.com/great-article-to-read",
      "release_date": null,
      "shares": {
        "facebook": 10,
        "linkedin": 1000,
        "twitter": 100
      },
      "sizes": {
        "original": {
          "width": null,
          "height": null,
          "url": "https://d3gvv7thuwd750.cloudfront.net/1000/screenshots/screenshot-taken-from-source-url.jpg"
        },
        "thumbnail": {
          "width": 512,
          "height": 384,
          "url": "https://d3gvv7thuwd750.cloudfront.net/1000/screenshots/1-screenshot-taken-from-source-url-thumbnail.jpg"
        }
      },
      "alexa": null,
      "private": false,
      "permalink": "/clippings/1-example-clipping",
      "type": "clipping",
      "show_iframe": true,
      "language": "en"
    }
  ],
  "paging": {
    "page": 0,
    "limit": 30,
    "total": 30
  }
}

Params

Param name Description
pressroom_id
required

Pressroom id or pressroom domain

Validations:

  • Must be a String
order
optional

Comma seperated list of attributes to orders results by (e.g. id desc, release_date asc)

Validations:

  • Must be a String
>>>

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

Retrieve a specific clipping

Supported Formats

json

Errors

Code Description
404 Missing

Examples

GET /v1/pressrooms/1000/clippings/1.json
200
{
  "data": {
    "id": 1,
    "pressroom_id": 1000,
    "press_release_id": null,
    "title": "Example clipping",
    "source": "thenextweb.com",
    "url": "http://thenextweb.com/great-article-to-read",
    "release_date": null,
    "shares": {
      "facebook": 10,
      "linkedin": 1000,
      "twitter": 100
    },
    "sizes": {
      "original": {
        "width": null,
        "height": null,
        "url": "https://d3gvv7thuwd750.cloudfront.net/1000/screenshots/screenshot-taken-from-source-url.jpg"
      },
      "thumbnail": {
        "width": 512,
        "height": 384,
        "url": "https://d3gvv7thuwd750.cloudfront.net/1000/screenshots/1-screenshot-taken-from-source-url-thumbnail.jpg"
      }
    },
    "alexa": null,
    "private": false,
    "permalink": "/clippings/1-example-clipping",
    "type": "clipping",
    "show_iframe": true,
    "language": "en"
  }
}

Params

Param name Description
pressroom_id
required

Pressroom id or pressroom domain

Validations:

  • Must be a String
id
required

Clipping id

Validations:

  • Must be a String