Twingly RPC Ping API

Introduction
Abuse
Request
- weblogUpdates.ping
- weblogUpdates.extendedPing
Response

Introduction

Twingly RPC Ping API is an XML-RPC API for sending “weblog pings”. It’s designed to work like weblogs.com “reference” API.

If you’d like to manually ping your blog, please use twingly.com/ping.

Abuse

Please do not abuse the API, you will most likely be blocked (silently). We’re only interested in blogs, so sending us news sites or webshops will also likely cause a block.

Request

Requests should be sent as HTTP POST to http://rpc.twingly.com/ with an XML body.

weblogUpdates.ping

Method: weblogUpdates.ping
Parameters:
- Name of site (required)
- URL of site or RSS feed (required)

<?xml version="1.0"?>
<methodCall>
    <methodName>weblogUpdates.ping</methodName>
    <params>
        <param>
            <value>Twingly Blog</value>
        </param>
        <param>
            <value>http://blog.twingly.com/</value>
        </param>
    </params>
</methodCall>

weblogUpdates.extendedPing

Method: weblogUpdates.extendedPing
Parameters:
- Name of site (required)
- URL of site or RSS feed (required)
- URL of the post (optional)
- URL of the feed (optional)
- A name or tag (optional)

<?xml version="1.0"?>
<methodCall>
    <methodName>weblogUpdates.extendedPing</methodName>
    <params>
        <param>
            <value>Twingly Blog</value>
        </param>
        <param>
            <value>http://blog.twingly.com/</value>
        </param>
        <param>
            <value>http://blog.twingl.com/new_post</value>
        </param>
        <param>
            <value>http://blog.twingly.com/feed/</value>
        </param>
        <param>
            <value>blog|search</value>
        </param>
    </params>
</methodCall>

Response

If you’ve sent a valid URL with a correct format, the successful response will look like:

<?xml version="1.0" ?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>flerror</name>
                        <value>
                            <boolean>0</boolean>
                        </value>
                    </member>
                    <member>
                        <name>message</name>
                        <value>
                            <string>Thanks for the ping.</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>

If you’ve failed, it will look like:

<?xml version="1.0" ?>
<methodResponse>
    <params>
        <param>
            <value>
                <struct>
                    <member>
                        <name>flerror</name>
                        <value>
                            <boolean>1</boolean>
                        </value>
                    </member>
                    <member>
                        <name>message</name>
                        <value>
                            <string>No URL to ping.</string>
                        </value>
                    </member>
                </struct>
            </value>
        </param>
    </params>
</methodResponse>