Socialid.selfie.posts
(Difference between revisions)
Dirceu.tiegs (Talk | contribs) |
Dirceu.tiegs (Talk | contribs) |
||
Line 46: | Line 46: | ||
|+ | |+ | ||
! align="left" width="200px" | status | ! align="left" width="200px" | status | ||
− | | | + | | API call status. Can be '''"success"''' on a successful search, or '''"internal_server_error"''' if any unknown error happens. |
|} | |} | ||
Revision as of 11:42, 4 November 2014
Contents |
Description
Searches for moderated posts for a given hashtag.
Usage
socialid.selfie.posts(hashtag, handler, options)
Parameters
hashtag | required | hashtag used to search the posts. | handler | optional | callback function to be called on the API response. | options | optional | object containing additional parameters. | 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. |
---|
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 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; socialid.selfie.init(appId); socialid.selfie.posts('focacbt', handler);
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 = { page: 2, limit: 40, order: 'like', user_id: '50.97.87.253' }; socialid.selfie.init(appId); socialid.selfie.posts('focacbt', 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/", provider: "instagram", thumb_picture_url: "http://scontent-b.cdninstagram.com/hphotos-xfa1/t51.2885-15/10632020_1540533216169293_1066110938_s.jpg", user_liked: true }], total: 1 }
The low_picture_url, thumb_picture_url, and user_liked properties may return as null depending on the post.