GET selfie/hashtags/:hashtag/approved
(Difference between revisions)
Renato.neves (Talk | contribs) (→Response Body) |
|||
Line 108: | Line 108: | ||
"thumb_picture_url": "http://photos-b.ak.instagram.com/hphotos-ak-xpf1/123-thumb.jpg", | "thumb_picture_url": "http://photos-b.ak.instagram.com/hphotos-ak-xpf1/123-thumb.jpg", | ||
"low_picture_url": "http://photos-b.ak.instagram.com/hphotos-ak-xpf1/123-low.jpg", | "low_picture_url": "http://photos-b.ak.instagram.com/hphotos-ak-xpf1/123-low.jpg", | ||
+ | "profile_picture_url": "http://photos-e.ak.instagram.com/hphotos-ak-xaf1/10632016_256085694602076_741961532_a.jpg", | ||
"post_url": "http://instagram.com/p/123/", | "post_url": "http://instagram.com/p/123/", | ||
− | "display_name": "thefashion", | + | "display_name": "The Fashion", |
+ | "username": "thefashion", | ||
"message": "I'm #fashion !", | "message": "I'm #fashion !", | ||
"likes": 150, | "likes": 150, |
Revision as of 19:02, 4 November 2014
Contents |
Description
Returns a list of approved posts for a hashtag.
Resource URL
GET https://api.socialidnow.com/v1/marketing/selfie/hashtags/:hashtag/approved
Parameters
URL Parameters
hashtag | required | hashtag identifier. |
---|---|---|
client_id | required | Marketing Account identifier. |
order | optional | results order. Available values: created_at; like. Default: created_at. |
page_size | optional | maximum amount of results to be returned. Default: 15. |
page | optional | page number (each page contains page_size results). Default: 1. |
user_id | optional | user identifier for likes information. |
Authentication
This API does not require authentication.
Response
Response Status
ok (200) | The search was performed successfully. |
---|---|
bad_request (400) | Some required parameter was not informed. |
not_found (404) | The hashtag was not found. |
not_found (422) | Validation error in the search parameters. |
internal_server_error (500) | An unknown error happened. |
Response Body
A successful search returns the following fields:
total | total amount of posts found. |
---|---|
count | amount of posts returned in the page (according to the specified page_size). |
offset | amount of posts discarded (page start, according to the specified page). |
results | array with post details. |
Examples
Request
Returns the third page with two approved posts for the hashtag "fashion', ordered by likes count, with likes information for the user identified by the IP "50.97.87.253".
curl -iX GET 'https://api.socialidnow.com/v1/marketing/selfie/hashtags/fashion/approved?order=like&page=3&page_size=2&client_id=138&user_id=50.97.87.253'
Response
Response Headers
HTTP/1.1 200 Ok Status: 200
Response Body
{ "total": 10, "count": 2, "offset": 4, "results": [ { "post_id": 123, "provider": "instagram", "picture_url": "http://photos-b.ak.instagram.com/hphotos-ak-xpf1/123.jpg", "thumb_picture_url": "http://photos-b.ak.instagram.com/hphotos-ak-xpf1/123-thumb.jpg", "low_picture_url": "http://photos-b.ak.instagram.com/hphotos-ak-xpf1/123-low.jpg", "profile_picture_url": "http://photos-e.ak.instagram.com/hphotos-ak-xaf1/10632016_256085694602076_741961532_a.jpg", "post_url": "http://instagram.com/p/123/", "display_name": "The Fashion", "username": "thefashion", "message": "I'm #fashion !", "likes": 150, "created_at": "2014-05-02T18:14:02Z", "user_liked": true }, { ... } ] }