Skip to main content

users/{userid}/feed (GET) (MT4)


Retrieve feed of user contributions

  • REST Method: GET
  • Method Access: public

Uri Parameters

Name Type Description
userid string either an integer user ID, "current", or "=" followed by a double uri-encoded user name

Query Parameters

Name Type Description
authenticate bool? Force authentication for request (default: false)
format {all, daily, raw, rawdaily}? Format for feed (default: daily)
offset int? Skipped changes (default: 0)
limit int? Number of changes to retrieve (default: 100)
since string? Start date for changes. Date is provided in 'yyyyMMddHHmmss' format (default: ignored).

Return Codes

Name Value Description
OK 200 The request completed successfully
Bad Request 400 Invalid input parameter or request body
Forbidden 403 Suscribe access is required
Not Found 404 Requested user could not be found

Message Format

Output (Atom):  Refer to

Output (Digest/Raw):


Implementation Notes

Atom and Digest formats retrieve a compressed summary of page changes, whereas the Raw format lists each change individually.

C# Code Sample: Retrieve Feed of Changes made by User

The following code example retrieves the feed of changes by the current user:

Sample Code

Plug p = Plug.New("http://deki-hayes/@api/deki");
p.At("users", "authenticate").WithCredentials("admin", "password").Get();
p.At("users", "current", "feed").Get();

Sample Response from executing Code

Sample response feed indicating that the current user edited the page called "Page Title" four times:

<feed xmlns="" version="1.0" xml:lang="en-us">
    <generator version="">MindTouch Dream XAtom</generator> 
    <title type="text">Admin's contributions</title> 
    <link rel="self" href="http://deki-hayes/@api/deki/users/current/feed" /> 
        <title type="text">Page Title</title> 
        <link href="http://deki-hayes/Page_Title" rel="alternate" /> 
        <summary type="xhtml">
            <div xmlns="">
                <p>Edited 4 times by Admin (added 'myfile.jpg')</p> 
                    <strong>2 words added, 1 words removed</strong> 
                <hr width="100%" size="2" /> 
                    <ins style="color: #009900;background-color: #ccffcc;text-decoration: none;">new</ins> 
                    <del style="color: #990000;background-color: #ffcccc;text-decoration: none;">original</del> 
                    <ins style="color: #009900;background-color: #ccffcc;text-decoration: none;">2</ins> 

Curl Code Sample: Retrieve Feed of Changes made by User

The following command returns a feed containing a list of page modifications made by user "foo":

Sample Code

curl -u username:password -i http://mindtouch.address/@api/deki/users/=foo/feed

Sample Response from executing Code

Example of a user feed:

Content-Type: application/xml

<feed xmlns="" xml:lang="en-us">
  <generator version="">MindTouch Dream XAtom</generator>
  <title type="text">spock's contributions</title>
  <link rel="self" href=""/>
    <title type="text">Bar</title>
    <link href="" rel="alternate"/>
    <summary type="xhtml">
      <div xmlns="">
        <p>Edited once by spock</p>
        <p>removed 'trollface.jpg'</p>
        <table border="0" padding="5" width="80%">
              <a href="">View page</a>
              <a href="">Ban spock</a>

Implementation notes 

curl flags

Provides external user authentication. Note that if anonymous access is available and authentication is not forced, this flag may be omitted.
Outputs the HTTP response headers. Useful for debugging.


To view a list of all users, follow the instructions here.
  • Was this article helpful?