This API version has been deprecated and no longer supported.

API

API is a special interface for developers to integrate features of our service to third-party web application. API provides tools for managing your user account – creating, receiving and managing updatable Sitemaps and RSS files. Working with the API is free for all accounts. You can enable the API and get the key in your personal account.

The access key should not be passed on to third parties or made visible in the code of web pages.

For security reasons, if you change your e-mail or password, your API key also changes.

Daily limit on the number of calls to the API - 500 requests.

If your integration algorithm requires frequent calls, we recommend that you use a local database to synchronize data, which allows queries only when necessary.

Documentation

The principle of using the API is the interaction of your application with the mysitemapgenerator.com server via the HTTP POST method.

All parameters must be passed in UTF-8 encoding. The API key must be passed as a POST variable named "api_key".

Server response comes in JSON format.

URL for sending HTTP requests:

http://www.mysitemapgenerator.com/api/{METHOD}?format=json

where {METHOD} – name of the method.

Call result

If the call is successful, the object will contain a "result" field with a value of "success".

Example of a successful method call response:

{   "result":  "success",   "source_id":  9874   }

A sign of an error when executing a method is the presence of the "result" field with the "error" value in the object. In addition, if an error occurs, the response will contain a "notice" field that contains a description of the cause of the error.

Example of an error response:

{   "result": "error", "notice": "invalid API key"   }

Your Account

getBalance
– returns the current balance of your account (for prepaid billing). A successful response will contain a field "balance".
Request:

    POST: http://www.mysitemapgenerator.com/api/getBalance?format=json HTTP/1.0\r\n
    .....
    \r\n
    api_key={yourAPIkey}

{   "result":  "success",   "balance":  9.8   }

Updatable Sitemaps

SitemapsGetList
– returns a list of updated Sitemaps, including url and identifier ("cid" parameter) of all sites.
Request:

    POST: http://www.mysitemapgenerator.com/api/SitemapsGetList?format=json HTTP/1.0\r\n
    .....
    \r\n
    api_key={yourAPIkey}

{
    "result":  "success",
    "resources":  [
        {"cid": 12345, "url": "http://www.mysite1.com/"},
        {"cid": 12346, "url": "http://www.mysite2.com/"}
    ]
}

SitemapsGetFiles
- returns a direct download link for a Sitemap based on the site identifier. If Sitemap consists of several files, links to all parts will be returned. Links are placed in an array "files".
Request:

    POST: http://www.mysitemapgenerator.com/api/SitemapsGetFiles?format=json HTTP/1.0\r\n
    .....
    \r\n
    api_key={yourAPIkey}&cid=12345

{
    "result":  "success",
    "files":  [
        "http://www.mysitemapgenerator.com/?action=download&xmlfile=12345"
    ]
}

SitemapsGetInfo
– returns Sitemap info based on the site identifier. Includes current status ("work_status" parameter), indexing options ("params" array), date of last indexing in RFC 2822 ("last_scan" parameter).
Request:

    POST: http://www.mysitemapgenerator.com/api/SitemapsGetInfo?format=json HTTP/1.0\r\n
    .....
    \r\n
    api_key={yourAPIkey}&cid=12345

{
    "result":  "success",
    "last_scan": "Mon, 02 Sep 2013 07:00:02 +0300",
    "params":  [{
        "site_url": "http://www.mysite1.com/",
        "site_noindex": 1,
        "site_nofollow": 1,
        "site_robots": 1,
        "site_forms": 0,
        "site_frames": 0,
        "site_javascripts": 0,
        "site_canonical": 0,
        "site_useragent": "default",
        "site_priority": 1,
        "site_lastmod": 1,
        "site_lastmod_source": "default",
        "site_limit": 35000,
        "site_load": "middle",
        "site_images": 0,
        "site_turbo": 1,
        "send_email": 0
    }]
}

Updatable RSS feeds

RssGetList
– получить список обновляемых RSS, содержит url и cid канала всех сайтов.
Request:

    POST: http://www.mysitemapgenerator.com/api/RssGetList?format=json HTTP/1.0\r\n
    .....
    \r\n
    api_key={yourAPIkey}

{
    "result":  "success",
    "resources":  [
        {"cid": 12345, "url": "http://www.mysite1.com/news/"},
        {"cid": 12346, "url": "http://www.mysite2.com/index.html"}
    ]
}

RssGetFile
- получить прямую ссылку для выгрузки RSS по идентификатору URL.
Request:

    POST: http://www.mysitemapgenerator.com/api/RssGetFile?format=json HTTP/1.0\r\n
    .....
    \r\n
    api_key={yourAPIkey}&cid=12345

{
    "result":  "success",
    "file":  "http://www.mysitemapgenerator.com/?action=ext&file=12345"
}

RssGetInfo
– получить информацию об обновляемом RSS по его идентификатору. Возвращает текущие статус ("work_status"), параметры обновления (массив "params"), дату последней индексации сайта в формате RFC 2822 ("last_scan") и сумму списанных с баланса средств ("last_cost").
Request:

    POST: http://www.mysitemapgenerator.com/api/RssGetInfo?format=json HTTP/1.0\r\n
    .....
    \r\n
    api_key={yourAPIkey}&cid=12345

{
    "result":  "success",
    "last_scan": "Mon, 02 Sep 2013 07:00:02 +0300",
    "params":  [{
        "found_url": "http://www.mysite1.com/news/",
        "found_mask": "",
        "items_limit": 20,
        "items_pubDate": "server",
        "channel_pubDate": "default",
        "channel_webMaster": "",
        "channel_image": "http://www.mysite1.com/logo.png",
        "encoding": "utf-8"
    }]
}

Quick start

PHP class for working with API:

Download ([[FILEMTIME:./sources/mysitemapgenerator.lib.zip]])

See examples of using the class.