List Aggregate Tagged Content REST Endpoint

URLs

GET api.ashx/v2/aggregatetaggedcontent.xml (or .json)

LIST aggregate tagged content.

Request Parameters

Name	Type	Description	Required
ContainerIds	`string`	Content container identifiers in csv format	Optional
IncludeSubContainers	`bool?`	Include sub containers	Optional
ApplicationIds	`string`	Content application identifiers in csv format	Optional
ApplicationTypeIds	`string`	Content application type identifiers in csv format	Optional
ContentTypeIds	`string`	Content type identifiers in csv format	Optional
Tags	`string`	A comma-seperated list of tags to filter by	Optional
TypeId	`Guid?`	Categorization type	Optional
ContentCreatedAfterDate	`DateTime?`	Include only content created on or after.	Optional
ContentCreatedBeforeDate	`DateTime?`	Include only content created before.	Optional
SortBy	`string`	Sort by 'TaggedDate' or 'CreatedDate'. Default is 'TaggedDate'.	Optional
SortOrder	`string`	Sort order 'Ascending' or 'Descending'	Optional
PageSize	`int?`	Page size to retrieve	Optional
PageIndex	`int?`	Page index to retrieve	Optional
LogicallyOrTags	`bool?`	Returns content matching any tag versus every tag	Optional

Example Requests

C# REST SDK

This example uses the REST SDK to access the Community REST API within a .Net C# application. In the example, USER_NAME is the user name of the effective user for the request and OAUTH_CLIENT_ID and OAUTH_SECRET are the OAuth client ID and secret, respectively, associated to this application as configured in Administration > Integration > OAuth Clients with the "Client Credentials" grant type enabled. See the documentation for the REST SDK for more details about installation, configuration, and usage options.

var host = new ClientCredentialsRestHost("USER_NAME", "https://mysite.com/", "OAUTH_CLIENT_ID", "OAUTH_SECRET");
var response = host.GetToDynamic(2, "aggregatetaggedcontent.json", false);

Widget Javascript

This example uses the rest JavaScript API to access the Community REST API within the Community web UI. When accessing the REST API through the javascript API, the effective user is the current contextual user of the web interface.

jQuery.telligent.evolution.get({
	url: jQuery.telligent.evolution.site.getBaseUrl() + 'api.ashx/v2/aggregatetaggedcontent.json',
	success: function(response) {

	}
});

cURL

This example uses the cURL command-line HTTP utility. ENCODED_TOKEN in the example is the base64-encoded concatenation of the user's API key (created from the user's profile), a colon (:), and the user's user name. Learn more about using the REST API.

curl -H "Rest-User-Token: ENCODED_TOKEN" -X GET https://mysite.com/api.ashx/v2/aggregatetaggedcontent.xml

Example Responses

XML

<?xml version="1.0" encoding="utf-16"?>
<Response>
  <Info>
    <Message>string</Message>
    <Message>string</Message>
  </Info>
  <Warnings>
    <Message>string</Message>
    <Message>string</Message>
  </Warnings>
  <Errors>
    <Message>string</Message>
    <Message>string</Message>
  </Errors>
  <AggregateTaggedContent PageSize="2" PageIndex="0" TotalCount="2">
    <AggregateTaggedContent>
      <TaggedDate>2012-01-04T00:00:00</TaggedDate>
      <Content>
        <CreatedByUser>
          <Id>25</Id>
          <AvatarUrl>avatarurl</AvatarUrl>
          <DisplayName>displayname</DisplayName>
          <ProfileUrl>profileurl</ProfileUrl>
          <Username>username</Username>
          <CurrentStatus>
            <Id>9ba1ec43-dc34-4e27-a579-4a0855144e2f</Id>
            <Author>
              <Id />
              <AvatarUrl>avatarurl</AvatarUrl>
              <DisplayName>displayname</DisplayName>
              <ProfileUrl>profileurl</ProfileUrl>
              <Username>username</Username>
            </Author>
            <Body>body</Body>
            <CreatedDate>2012-05-02T00:00:00</CreatedDate>
            <ReplyCount>6</ReplyCount>
            <Group>
              <Id />
              <AvatarUrl>avatarurl</AvatarUrl>
              <DateCreated />
              <Description>description</Description>
              <Key>key</Key>
              <Name>name</Name>
              <Url>url</Url>
              <TotalMembers />
              <HasGroups>true</HasGroups>
              <GroupCount />
              <GroupType>grouptype</GroupType>
              <EnableGroupMessages>true</EnableGroupMessages>
              <EnableContact>true</EnableContact>
              <SearchUniqueId>searchuniqueid</SearchUniqueId>
              <ExtendedAttributes />
              <ContainerId>49fec544-6df7-4a82-872b-f8be586d5e9e</ContainerId>
            </Group>
            <AttachedUrl>attachedurl</AttachedUrl>
            <ContentId>9ba1ec43-dc34-4e27-a579-4a0855144e2f</ContentId>
            <ContentType>56f1a3ec-14bb-45c6-949f-ee7776d68c78</ContentType>
            <Url>url</Url>
            <IsPublished>true</IsPublished>
            <Content>
              <ContentId>2d525bad-c4df-470d-a193-a1c6d66e5c3e</ContentId>
              <ContentTypeId>bd519379-b61f-4e2f-b0f9-c0f28c5cceb1</ContentTypeId>
              <CreatedDate>2012-06-04T00:00:00</CreatedDate>
              <HtmlName>htmlname</HtmlName>
              <HtmlDescription>htmldescription</HtmlDescription>
              <Url>url</Url>
              <AvatarUrl>avatarurl</AvatarUrl>
            </Content>
          </CurrentStatus>
        </CreatedByUser>
        <ContentId>e3715662-2528-4ba1-84a7-bfcd9d548f80</ContentId>
        <ContentTypeId>6cdcf200-3bad-476d-af45-97b52545c337</ContentTypeId>
        <CreatedDate>2011-05-28T00:00:00</CreatedDate>
        <HtmlName>htmlname</HtmlName>
        <HtmlDescription>htmldescription</HtmlDescription>
        <Url>url</Url>
        <AvatarUrl>avatarurl</AvatarUrl>
        <Application>
          <ApplicationId>b04540ec-eb38-4fa1-b7bb-e3fde05401b4</ApplicationId>
          <ApplicationTypeId>44df201a-07e6-42eb-96c7-8ce7ce35aab6</ApplicationTypeId>
          <HtmlName>htmlname</HtmlName>
          <HtmlDescription>htmldescription</HtmlDescription>
          <Url>url</Url>
          <AvatarUrl>avatarurl</AvatarUrl>
          <Container>
            <ContainerId>49fec544-6df7-4a82-872b-f8be586d5e9e</ContainerId>
            <ContainerTypeId>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</ContainerTypeId>
            <HtmlName>htmlname</HtmlName>
            <Url>url</Url>
            <AvatarUrl>avatarurl</AvatarUrl>
          </Container>
        </Application>
      </Content>
    </AggregateTaggedContent>
    <AggregateTaggedContent>
      <TaggedDate>2011-12-09T00:00:00</TaggedDate>
      <Content>
        <CreatedByUser>
          <Id>4</Id>
          <AvatarUrl>avatarurl</AvatarUrl>
          <DisplayName>displayname</DisplayName>
          <ProfileUrl>profileurl</ProfileUrl>
          <Username>username</Username>
          <CurrentStatus>
            <Id>6cdcf200-3bad-476d-af45-97b52545c337</Id>
            <Author>
              <Id />
              <AvatarUrl>avatarurl</AvatarUrl>
              <DisplayName>displayname</DisplayName>
              <ProfileUrl>profileurl</ProfileUrl>
              <Username>username</Username>
            </Author>
            <Body>body</Body>
            <CreatedDate>2012-03-29T00:00:00</CreatedDate>
            <ReplyCount>8</ReplyCount>
            <Group>
              <Id />
              <AvatarUrl>avatarurl</AvatarUrl>
              <DateCreated />
              <Description>description</Description>
              <Key>key</Key>
              <Name>name</Name>
              <Url>url</Url>
              <TotalMembers />
              <HasGroups>true</HasGroups>
              <GroupCount />
              <GroupType>grouptype</GroupType>
              <EnableGroupMessages>true</EnableGroupMessages>
              <EnableContact>true</EnableContact>
              <SearchUniqueId>searchuniqueid</SearchUniqueId>
              <ExtendedAttributes />
              <ContainerId>fe65240b-044c-4292-9946-f10e0361ecff</ContainerId>
            </Group>
            <AttachedUrl>attachedurl</AttachedUrl>
            <ContentId>6cdcf200-3bad-476d-af45-97b52545c337</ContentId>
            <ContentType>56f1a3ec-14bb-45c6-949f-ee7776d68c78</ContentType>
            <Url>url</Url>
            <IsPublished>true</IsPublished>
            <Content>
              <ContentId>9ba1ec43-dc34-4e27-a579-4a0855144e2f</ContentId>
              <ContentTypeId>e3715662-2528-4ba1-84a7-bfcd9d548f80</ContentTypeId>
              <CreatedDate>2012-04-19T00:00:00</CreatedDate>
              <HtmlName>htmlname</HtmlName>
              <HtmlDescription>htmldescription</HtmlDescription>
              <Url>url</Url>
              <AvatarUrl>avatarurl</AvatarUrl>
            </Content>
          </CurrentStatus>
        </CreatedByUser>
        <ContentId>b04540ec-eb38-4fa1-b7bb-e3fde05401b4</ContentId>
        <ContentTypeId>44df201a-07e6-42eb-96c7-8ce7ce35aab6</ContentTypeId>
        <CreatedDate>2012-01-16T00:00:00</CreatedDate>
        <HtmlName>htmlname</HtmlName>
        <HtmlDescription>htmldescription</HtmlDescription>
        <Url>url</Url>
        <AvatarUrl>avatarurl</AvatarUrl>
        <Application>
          <ApplicationId>49fec544-6df7-4a82-872b-f8be586d5e9e</ApplicationId>
          <ApplicationTypeId>9f5a6721-639d-4e1d-ab6a-ce63b7750f46</ApplicationTypeId>
          <HtmlName>htmlname</HtmlName>
          <HtmlDescription>htmldescription</HtmlDescription>
          <Url>url</Url>
          <AvatarUrl>avatarurl</AvatarUrl>
          <Container>
            <ContainerId>fe65240b-044c-4292-9946-f10e0361ecff</ContainerId>
            <ContainerTypeId>2d525bad-c4df-470d-a193-a1c6d66e5c3e</ContainerTypeId>
            <HtmlName>htmlname</HtmlName>
            <Url>url</Url>
            <AvatarUrl>avatarurl</AvatarUrl>
          </Container>
        </Application>
      </Content>
    </AggregateTaggedContent>
  </AggregateTaggedContent>
</Response>

JSON

{
  "PageSize": 2,
  "PageIndex": 0,
  "TotalCount": 2,
  "AggregateTaggedContent": [
    {
      "TaggedDate": "2012-01-04T00:00:00",
      "Content": {
        "CreatedByUser": {
          "AvatarUrl": "avatarurl",
          "DisplayName": "displayname",
          "ProfileUrl": "profileurl",
          "Username": "username",
          "CurrentStatus": {
            "Author": {
              "AvatarUrl": "avatarurl",
              "DisplayName": "displayname",
              "ProfileUrl": "profileurl",
              "Username": "username",
              "CurrentStatus": null,
              "Id": null
            },
            "Body": "body",
            "CreatedDate": "2012-05-02T00:00:00",
            "ReplyCount": 6,
            "Group": {
              "AvatarUrl": "avatarurl",
              "DateCreated": null,
              "Description": "description",
              "Key": "key",
              "Name": "name",
              "Url": "url",
              "TotalMembers": null,
              "HasGroups": true,
              "GroupCount": null,
              "GroupType": "grouptype",
              "EnableGroupMessages": true,
              "EnableContact": true,
              "SearchUniqueId": "searchuniqueid",
              "IsEnabled": true,
              "ExtendedAttributes": [],
              "ContainerId": "49fec544-6df7-4a82-872b-f8be586d5e9e",
              "ContainerTypeId": "23b05a61-c3e5-4451-90d9-bfa00453bce4",
              "Container": null,
              "Id": null
            },
            "AttachedUrl": "attachedurl",
            "HasReplies": true,
            "ContentId": "9ba1ec43-dc34-4e27-a579-4a0855144e2f",
            "ContentType": "56f1a3ec-14bb-45c6-949f-ee7776d68c78",
            "Url": "url",
            "IsPublished": true,
            "Content": {
              "CreatedByUser": null,
              "ContentId": "2d525bad-c4df-470d-a193-a1c6d66e5c3e",
              "ContentTypeId": "bd519379-b61f-4e2f-b0f9-c0f28c5cceb1",
              "CreatedDate": "2012-06-04T00:00:00",
              "HtmlName": "htmlname",
              "HtmlDescription": "htmldescription",
              "Url": "url",
              "AvatarUrl": "avatarurl",
              "Application": null
            },
            "Id": "9ba1ec43-dc34-4e27-a579-4a0855144e2f"
          },
          "Id": 25
        },
        "ContentId": "e3715662-2528-4ba1-84a7-bfcd9d548f80",
        "ContentTypeId": "6cdcf200-3bad-476d-af45-97b52545c337",
        "CreatedDate": "2011-05-28T00:00:00",
        "HtmlName": "htmlname",
        "HtmlDescription": "htmldescription",
        "Url": "url",
        "AvatarUrl": "avatarurl",
        "Application": {
          "ApplicationId": "b04540ec-eb38-4fa1-b7bb-e3fde05401b4",
          "ApplicationTypeId": "44df201a-07e6-42eb-96c7-8ce7ce35aab6",
          "HtmlName": "htmlname",
          "HtmlDescription": "htmldescription",
          "Url": "url",
          "AvatarUrl": "avatarurl",
          "Container": {
            "ContainerId": "49fec544-6df7-4a82-872b-f8be586d5e9e",
            "ContainerTypeId": "9f5a6721-639d-4e1d-ab6a-ce63b7750f46",
            "HtmlName": "htmlname",
            "Url": "url",
            "AvatarUrl": "avatarurl"
          }
        }
      }
    },
    {
      "TaggedDate": "2011-12-09T00:00:00",
      "Content": {
        "CreatedByUser": {
          "AvatarUrl": "avatarurl",
          "DisplayName": "displayname",
          "ProfileUrl": "profileurl",
          "Username": "username",
          "CurrentStatus": {
            "Author": {
              "AvatarUrl": "avatarurl",
              "DisplayName": "displayname",
              "ProfileUrl": "profileurl",
              "Username": "username",
              "CurrentStatus": null,
              "Id": null
            },
            "Body": "body",
            "CreatedDate": "2012-03-29T00:00:00",
            "ReplyCount": 8,
            "Group": {
              "AvatarUrl": "avatarurl",
              "DateCreated": null,
              "Description": "description",
              "Key": "key",
              "Name": "name",
              "Url": "url",
              "TotalMembers": null,
              "HasGroups": true,
              "GroupCount": null,
              "GroupType": "grouptype",
              "EnableGroupMessages": true,
              "EnableContact": true,
              "SearchUniqueId": "searchuniqueid",
              "IsEnabled": true,
              "ExtendedAttributes": [],
              "ContainerId": "fe65240b-044c-4292-9946-f10e0361ecff",
              "ContainerTypeId": "23b05a61-c3e5-4451-90d9-bfa00453bce4",
              "Container": null,
              "Id": null
            },
            "AttachedUrl": "attachedurl",
            "HasReplies": true,
            "ContentId": "6cdcf200-3bad-476d-af45-97b52545c337",
            "ContentType": "56f1a3ec-14bb-45c6-949f-ee7776d68c78",
            "Url": "url",
            "IsPublished": true,
            "Content": {
              "CreatedByUser": null,
              "ContentId": "9ba1ec43-dc34-4e27-a579-4a0855144e2f",
              "ContentTypeId": "e3715662-2528-4ba1-84a7-bfcd9d548f80",
              "CreatedDate": "2012-04-19T00:00:00",
              "HtmlName": "htmlname",
              "HtmlDescription": "htmldescription",
              "Url": "url",
              "AvatarUrl": "avatarurl",
              "Application": null
            },
            "Id": "6cdcf200-3bad-476d-af45-97b52545c337"
          },
          "Id": 4
        },
        "ContentId": "b04540ec-eb38-4fa1-b7bb-e3fde05401b4",
        "ContentTypeId": "44df201a-07e6-42eb-96c7-8ce7ce35aab6",
        "CreatedDate": "2012-01-16T00:00:00",
        "HtmlName": "htmlname",
        "HtmlDescription": "htmldescription",
        "Url": "url",
        "AvatarUrl": "avatarurl",
        "Application": {
          "ApplicationId": "49fec544-6df7-4a82-872b-f8be586d5e9e",
          "ApplicationTypeId": "9f5a6721-639d-4e1d-ab6a-ce63b7750f46",
          "HtmlName": "htmlname",
          "HtmlDescription": "htmldescription",
          "Url": "url",
          "AvatarUrl": "avatarurl",
          "Container": {
            "ContainerId": "fe65240b-044c-4292-9946-f10e0361ecff",
            "ContainerTypeId": "2d525bad-c4df-470d-a193-a1c6d66e5c3e",
            "HtmlName": "htmlname",
            "Url": "url",
            "AvatarUrl": "avatarurl"
          }
        }
      }
    }
  ],
  "Info": [
    "string",
    "string"
  ],
  "Warnings": [
    "string",
    "string"
  ],
  "Errors": [
    "string",
    "string"
  ]
}

Recommended