API Methods: articles.getList



Description

Gets a list of articles for a specific category.

Authentication

This method requires authentication without user credentials.

Required parameters

Optional parameters

  • article_id :
    the id number of a particular article
  • date_posted : the date the article was posted formatted as a UNIX time stamp.
  • description : a brief description of the article.
  • title : the title of the article.
  • ss_key : the key of the community associated with the article. The list of communities is available from the communities.getList call.
  • interest_key : the key of a site interest associated with the article. The list of interests is available from the siteinterests.getList call.
  • subinterest_key : the key of a site sub-interest associated with the article. The list of interests is available from the siteinterests.getList call.

Example response

<?xml version="1.0"?>
<response status="ok" time="Fri, 18 Apr 2008 10:50:12 -0500">
    <articles count="2" total="31">
        <article>
            <category_id>2</category_id>
            <article_id>1</article_id>

            <date_posted>1182800320</date_posted>
            <description>
                <![CDATA[This is just one of the best resources available to communicators. This is just one of the best resources available to communicators. This is just one of the best resources available to communicators. This is just one of the best resources available to communicators. This is just one of the best resources available to communicators. This is just one of the best resources available to communicators. This is just one of the best resources available to communicators.<br />]]>
            </description>
            <title>

                <![CDATA[Comms Network]]>
            </title>
        </article>
        <article>
            <category_id>2</category_id>

            <article_id>2</article_id>
            <date_posted>1182803139</date_posted>
            <description>
                <![CDATA[This is a long description.&nbsp; This is a long description.&nbsp; This is a long description.&nbsp; This is a long description.&nbsp; This is a long description.&nbsp; This is a long description.<br />

                &nbsp;  ]]>
            </description>
            <title>
                <![CDATA[Blog]]>
            </title>
        </article>

    </articles>
</response>