Retrieve a Social URL
URL
https://api.zoomrank.com/users/:user_id/social/urls/:id.:format
Supported formats
xml, json
Supported request methods
GET
Example
Retrieve Social URL with ZoomRank ID 3 for user with ZoomRank ID 5.
https://api.zoomrank.com/users/5/social/urls/3.json
Response Codes
200
- Success404
- No records found
Social URL Object
Field | Description | Format |
---|---|---|
external_id | Your unique identifier | char(125) |
category_id | ZoomRank Category ID | int |
url | URL | char(255) |
ranking_dow | Weekly ranking day-of-week (if weekly-balanced ranked) | 0 - 6 (0 = Sunday) |
ranking_dom | Monthly ranking day (if monthly ranked) | 1 - 28 |
last_ranked_date | Date of which record was last ranked | YYYY-MM-DD |
Example Response (JSON)
{ "id":3, "external_id":"MYID", "domain":"test.com", "url":"http://test.com", "category":"my category", "ranking_dow":null, "ranking_dom":null, "created_at":"2014-02-28T13:20:27-06:00", "metrics":{ "id":20, "date":"2014-03-25", "plus1s":582, "plus1s_change":null, "tweets":5139, "tweets_change":2, "pins":75, "pins_change":null, "fb_shares":30, "fb_shares_change":-1, "fb_likes":5866, "fb_likes_change":-134, "fb_comments":33407, "fb_comments_change":null, "fb_clicks":1200, "fb_clicks_change":5 } }
Example Response (XML)
<?xml version="1.0" encoding="UTF-8"?> <url id="1"> <external_id>MYID</external_id> <category>my category</category> <domain>zoomrank.com</url> <url>http://zoomrank.com</url> <ranking_dow></ranking_dow> <ranking_dom></ranking_dom> <created_at>2014-02-25 16:26:17 -0600</created_at> <metrics id="19"> <date>2014-03-25</date> <plus1s>53</plus1s> <plus1s_change></plus1s_change> <tweets>0</tweets> <tweets_change></tweets_change> <pins>0</pins> <pins_change></pins_change> <fb_shares>10</fb_shares> <fb_shares_change>1</fb_shares_change> <fb_likes>4</fb_likes> <fb_likes_change></fb_likes_change> <fb_comments>1</fb_comments> <fb_comments_change></fb_comments_change> <fb_clicks>420</fb_clicks> <fb_clicks_change></fb_clicks_change> </metrics> </url>