< Back to zoomrank.com

Create a keyword

URL

https://api.zoomrank.com/users/:user_id/local/listings/:listing_id/keywords.xml

Supported formats

xml, json

Supported request methods

POST

Example

Create a new keyword for listing with ZoomRank ID 1200.

https://api.zoomrank.com/users/1/local/listings/1200/keywords.xml

Arguments

Argument Description
keyword The new keyword record sent in the request body.

Local Keyword Object

Field Description Format
category_id ZoomRank Category ID int
external_id Your unique identifier char(125)
keyword Phrase/keyword char(100)
location The city and state to perform ranking from City,ST (example: Dallas,TX)
ranking_dow Weekly ranking day-of-week 0 - 6 (0 = Sunday)
ranking_dom Monthly ranking day 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

<keyword>
	<category_id>395</category_id>
	<external_id></external_id>
	<keyword>pizza dallas</keyword>
	<location>Dallas,TX</location>
</keyword>