Statuses/mentions

«  Return to the list of API methods

Contents

URL

http://yourserver/api/statuses/mentions.format

Description

It returns the last 25 replies or statuses containing @user of the authentificated user

This is an alias of statuses/mentions

Available formats

RSS, XML, JSON

HTTP Method

GET

Requires authentication

YES

Optional parameters

Return example (XML)

curl http://yourserver/api/statuses/mentions.xml
<?xml version="1.0" encoding="UTF-8"?>
<statuses type="array">
 <status>
  <id>31</id>
  <created_at>Sat Apr 17 12:13:37 +0000 2010</created_at>
  <text>@marcosgdf abc</text>
  <source>web</source>
  <truncated>false</truncated>
  <in_reply_to_status_id>28</in_reply_to_status_id>
  <in_reply_to_user_id>1</in_reply_to_user_id>
  <favorited>false</favorited>
  <in_reply_to_screen_name></in_reply_to_screen_name>
  <user>
   <id>2</id>
   <name>lorena</name>
   <screen_name>lorena</screen_name>
   <location/>
   <description/>
   <profile_image_url>http://localhost/trunk/static/img/avatar/default_note.png</profile_image_url>
   <url/>
   <protected>true</protected>
   <followers_count>0</followers_count>
   <created_at>Fri Apr 16 20:13:05 +0000 2010</created_at>
   <favourites_count>1</favourites_count>
   <statuses_count>7</statuses_count>
   <friends_count>0</friends_count>
   <following>false</following>
   <utc_offset/>
   <geo_enabled>false</geo_enabled>
   <time_zone/>
   <profile_background_image_url>http://localhost/trunk/themes/transparency/img/bg.png</profile_background_image_url>
   <profile_background_tile>false</profile_background_tile>
   <notifications>false</notifications>
   <verified>false</verified>
   <lang>default</lang>
   <contributors_enabled>false</contributors_enabled>
  </user>
 </status>
</statuses>

Return example (JSON)

curl http://yourserver/api/statuses/mentions.json
[
    {
        "id": 31,
        "created_at": "Sat Apr 17 12:13:37 +0000 2010",
        "text": "@marcosgdf abc",
        "source": "web",
        "truncated": false,
        "in_reply_to_status_id": "28",
        "in_reply_to_user_id": "1",
        "in_reply_to_screen_name": "marcosgdf",
        "geo": null,
        "favorited": false,
        "contributors": null,
        "coordinates": null,
        "user": {
            "id": 2,
            "name": "lorena",
            "screen_name": "lorena",
            "location": null,
            "description": "",
            "profile_image_url": "http:\/\/localhost\/trunk\/static\/img\/avatar\/default_note.png",
            "url": null,
            "protected": true,
            "followers_count": "0",
            "created_at": "Fri Apr 16 20:13:05 +0000 2010",
            "favourites_count": "1",
            "statuses_count": "7",
            "friends_count": "0",
            "following": false,
            "utc_offset": null,
            "time_zone": null,
            "profile_background_image_url": "http:\/\/localhost\/trunk\/themes\/transparency\/img\/bg.png",
            "profile_background_tile": false,
            "notifications": false,
            "verified": false,
            "lang": "default",
            "contributions_enabled": false,
            "geo_enabled": false
        }
    }
]

Return example (RSS)

curl http://yourserver/api/statuses/mentions.rss
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" xmlns:dc="http://purl.org/dc/elements/1.1/">
 <channel>
  <title><![CDATA[jiskotest // Replies for marcosgdf]]></title>
  <description><![CDATA[Replies for marcosgdf]]></description>
  <link>http://localhost/trunk/statuses/mentions.rss</link>
  <atom:link href="http://localhost/trunk/statuses/mentions.rss" rel="self" type="application/rss+xml"/>
  <generator>Jisko</generator>
  <ttl>10</ttl>
  <image>
   <link>http://localhost/trunk/</link>
   <title>Replies for marcosgdf</title>
   <url>http://localhost/trunk/static/img/logos/logo.png</url>
  </image>
  <item>
   <title><![CDATA[lorena: @marcosgdf abc]]></title>
   <description><![CDATA[lorena: @marcosgdf abc]]></description>
   <pubDate>Sat, 17 Apr 2010 14:13:37 +0200</pubDate>
   <link>http://localhost/trunk/lorena/31</link>
   <guid>http://localhost/trunk/lorena/31</guid>
   <dc:creator>lorena</dc:creator>
   <source url="http://localhost/trunk/rss/profile?u=lorena">lorena's notes feed</source>
  </item>
 </channel>
</rss>