Sharing Pages API \ List all shared pages PHP SDK

Send a GET request to this endpoint to obtain the list of pages that have been shared by your users.

Resource/URI GET POST PUT DELETE
Shared Pages /sharing/pages.json List all shared pages
Shared Page /sharing/pages/<sharing_page_token>.json /sharing/pages/page.json?page_url=<page_url> Get page details

Workflow

Request: the code to send to the API

Send a GET request to the endpoint /sharing/pages.json to obtain the list of pages that have been shared by your users.

Result: the code returned by the API

The API returns a list of pages that have at least been shared once. Each entry includes a sharing_page_token that you can use to obtain more information about the page (e.g. the date, time and gelocation of the different shares). Requests that return multiple entries will be paginated to 250 items by default.

Example Resultset

{
    "response": {
      "request": {
        "date": "Thu, 12 Nov 2015 12:09:32  0100",
        "resource": "/sharing/pages.json",
        "status": {
          "flag": "success",
          "code": 200,
          "info": "Your request has been processed successfully"
        }
      },
      "result": {
        "data": {
          "sharing_pages": {
            "pagination": {
              "current_page": 1,
              "total_pages": 1,
              "entries_per_page": 250,
              "total_entries": 1,
              "order": {
                "field": "date_first_shared",
                "direction": "desc"
              }
            },
            "count": 1,
            "entries": [
              {
                "sharing_page_token": "023f93e0-2968-47f4-a6d7-e77d232a2125",
                "meta_title": "Social Login, Sign On & Social Network Sharing | oneall.com",
                "url": "http://www.oneall.com",
                "date_first_shared": "Wed, 01 Jan 2012 10:05:51  0100",
                "date_last_shared": "Wed, 25 Feb 2015 11:14:13  0100",
                "num_times_shared": 12075,
                "targets": [
                  {
                    "name": "Twitter",
                    "key": "twitter",
                    "num_times_shared": 2210
                  },
                  {
                    "name": "Facebook",
                    "key": "facebook",
                    "num_times_shared": 9231
                  },
                  {
                    "name": "LinkedIn",
                    "key": "linkedin",
                    "num_times_shared": 634
                  }
                ]
              }  
            ]
          }
        }
      }
    }
  }

User Contributed Notes