Update the site list using an HTTP request

The list of search topic sites can be updated programmatically using a special POST request. When Yandex Site Search receives such a POST request, it automatically sends the updated topic for moderation.

Authorization

To update the topic sites using POST requests, you must specify the IP address or subnet of the servers from which the requests will be sent in the topic properties. For example, 93.158.156.27/64.

You also need to enter the topic key. You can find it on your search topics page. Note: when the IP address changes, a new key is generated.

Request formation

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

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

The request must also specify the following parameters:

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

For example, if the key is b11f3e1d35a1a01cb009a19dcf8f259b4bcaaf33, the login is some_login, the topic id is 43210123, and the list of sites is:

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

The request should 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
Contact support