Socialid.selfie.posts

From Social ID Developers
Jump to: navigation, search

Deprecation notice: this API is deprecated since July 19, 2018.

Contents

Description

Searches for moderated posts for a given hashtag.

Usage

 socialid.selfie.posts(handler, options)

Important: the parameters in the format socialid.selfie.posts(hashtag, handler, options) are deprecated. Use the hashtag parameter as an option.

Parameters

handler required callback function to be called on the API response.
options optional object containing additional parameters.
hashtag optional hashtag used to search the posts. If no hashtag is informed, the API will return posts from all hashtags registered in the app.
page optional results page number. Default: 1.
limit optional max number of results per page. Default: 15.
order optional results sort order. Can be "created_at" to sort by post creation date in descending order, or "like" to sort by number of likes in descending order. Default: "created_at".
user_id optional user identifier ("user_liked" attribute in the response). Default: User IP. This parameter is deprecated.

API Response

data In case of success, an object containing search results. The object has the following properties: "results", "offset", "count", and "total".
status API call status. Can be "success" on a successful search, or "internal_server_error" if any unknown error happens.

Example

Returns the last moderated posts for all hashtags, with default options:

 var handler = function(response) {
    if (response.status == "success") {
       console.log(response.data.results);
    } else {
       alert("Couldn't perform the search.");
    }
 }
 var appId = 1;
 socialid.selfie.init(appId);
 socialid.selfie.posts(handler);

Returns the last moderated posts for the "focacbt" hashtag, with default options:

 var handler = function(response) {
    if (response.status == "success") {
       console.log(response.data.results);
    } else {
       alert("Couldn't perform the search.");
    }
 }
 var appId = 1,
       options = {
         hashtag: 'focacbt'
       };
 socialid.selfie.init(appId);
 socialid.selfie.posts(handler, options);

Returns the last moderated posts for the "focacbt" hashtag, with custom options:

 var handler = function(response) {
    if (response.status == "success") {
       console.log(response.data.results);
    } else {
       alert("Couldn't perform the search.");
    }
 }
 var appId = 1,
      options = {
        hashtag: 'focacbt',
        page: 2,
        limit: 40,
        order: 'like',
        user_id: '50.97.87.253'
      };
 socialid.selfie.init(appId);
 socialid.selfie.posts(handler, options);

Example "data" object:

 data = {
   count: 1,
   offset: 0,
   results: [{
     created_at: "2014-08-28T15:32:20+00:00",
     display_name: "Jennyffer Suellen",
     likes: 0,
     low_picture_url: "http://scontent-b.cdninstagram.com/hphotos-xfa1/t51.2885-15/10632020_1540533216169293_1066110938_a.jpg",
     message: "Foca no iguana #focacbt",
     picture_url: "http://scontent-b.cdninstagram.com/hphotos-xfa1/t51.2885-15/10632020_1540533216169293_1066110938_n.jpg",
     post_id: 3,
     post_url: "http://instagram.com/p/sP0HM_jwVv/",
     profile_picture_url: "http://photos-e.ak.instagram.com/hphotos-ak-xaf1/10632016_256085694602076_741961532_a.jpg",
     provider: "instagram",
     thumb_picture_url: "http://scontent-b.cdninstagram.com/hphotos-xfa1/t51.2885-15/10632020_1540533216169293_1066110938_s.jpg",
     user_liked: true,
     username: "jennyffer.suellen"
   }],
   total: 1
 }

The low_picture_url, thumb_picture_url, and user_liked properties may return as null depending on the post.

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox