< Back to zoomrank.com

Create a Social URL

URL

https://api.zoomrank.com/users/:user_id/social/urls.:format

Supported formats

xml, json

Supported request methods

POST

Example

Create a new Social URL for user with ZoomRank ID 1.

https://api.zoomrank.com/users/1/social/urls.json

Arguments

Argument Description
The new Social URL record sent in the request body.

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

Response Codes

201 - Success (Created)
400 - Bad Request (Errors occurred while creating record - See response body)
500 - Internal Server Error (Something bad happened, let us know!)

Example Request Body (JSON)

	
{
	"url": {
		"category_id": 1,
		"external_id": "MYID",
		"url": "http://api.zoomrank.com"    
	}
}

Example Request Body (XML)

<url>
	<category_id>1</category_id>
	<external_id>MYID</external_id>
	<url>http://api.zoomrank.com</url>
</url>