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>