Set your default language: PHP | Curl

GET timeline/public

A public timeline of whitelisted users who's Pings are available to the public. Useful for generating content for a user who may not follow anybody.

Ordered by Ping ID in desending order (i.e. highest Ping ID is first).

Details

URL https://api.heello.com/timeline/public.format
Requires Authentication No
Rate Limited Yes
Response Formats json

Parameters

Parameter Required Notes
key The application ID for the application making the request.
min_id Limit the result to no pings lower than this ID. This is useful for 'pull to refresh' functionality.

For example, you would take the last ping ID that the user has seen and set that as the min_id - No pings with an id lower than that will be returned in the timeline response.
max_id Limit the result to no pings higher than this ID. This is useful for paging to the next page of pings.

For example, if you pull a timeline page of 20 pings, and the last ID on the first page is 7838483, to get the next page, you would set that as the max_id, and all of the pings returned will have an ID less than 7838483.

The result is non-inclusive, and WILL NOT contain the ping data for 7838483.
count The number is pings you want returned. You can set this up to 200 max, after which we will limit the result to the last 200 pings. Default is 20.

Errors

There are no unique error states for this endpoint, please see our page detailing general errors you may encounter.

Example Usage

GET https://api.heello.com/timeline/public.json
curl https://api.heello.com/timeline/public.json?key=APPLICATION_KEY&count=20
// Note: PHP Examples use the Heello PHP Client library
// https://github.com/Heello/heello-php
require_once dirname(dirname(dirname(__FILE__))) . '/Heello.php';

// You can get an Application Key and Secret by visiting:
// http://developer.heello.com/apps
$api_application_key = "APPLICATION_KEY";
$api_application_secret = "APPLICATION_SECRET";

$api = new Heello\Client($api_application_key, $api_application_secret);

try{
  $pings = $api->timeline->public(array(
    "count" => 2,
  ));

  print_r($pings);
} catch (Exception $e){
  print $e->getMessage();
}
Please use the "Live Demo" below to see an example response.
You may need to login or create an account before making requests against the API.

Live Demo

Please login and create an application to perform live API testing.