GET selfie/hashtags/:hashtag/approved

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

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	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.
unprocessable_entity (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
      },
      { ... }
    ]
 }