Updating the list of sites using an HTTP request

The list of search topic sites can be updated programmatically using a special POST request. By getting such a POST request, Yandex Site Search automatically submits the updated topic for moderation.

Authorization

To update the sites of the topic using POST requests, specify the IP address or subnet of your request-originating servers. For example: 93.158.156.27/64.

You also need to specify the key of the topic. Its value can be found on your search topics page. Note: the key is re-generated when the IP address changes.

Forming a request

To update the list of topic sites, send a POST request to the address http://site.yandex.ru/update_urls.xml. The request must contain the Content-Type header:

Content-Type: application/x-www-form-urlencoded

The following parameters must also be specified in the request:

key=<topic key>&id=<login>&category_id=<topic id>&urls=<urlencoded site list>

For example, if the key is b11f3e1d35a1a01cb009a19dcf8f259b4bcaaf33, login is some_login, topic ID is 43210123, and the site list is as follows:

some-site-000.com
some-site-001.com 
some-site-002.com 
some-site-003.com

The request must look like this:

POST /update_urls.xml HTTP/1.1
Content-type: application/x-www-form-urlencoded
Host: site.yandex.ru
Content-Length: 174

key=b11f3e1d35a1a01cb009a19dcf8f259b4bcaaf33&id=some_login&category_id=43210123& 
urls=some-site-000.com%0Asome-site-001.com%0Asome-site-002.com%0Asome-site-003.com