< Back to zoomrank.com

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 - Success
404 - 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>