Metadata REST API (v 3.3)

/rest/communardo/metadata/latest/filter/{pagenumber} GET

Search for Confluence content and its metadata. You can search with Confluence query language (CQL) or Lucene query language or combine them.

parameter		required	default	possible values / type
pagenumber	the pagenumber of the result list			INTEGER greater 0
query	Lucene query	Either the query parameter or the cql parameter has to be defined
cql	Confluence query language	Either the query parameter or the cql parameter has to be defined
sort	column to sort by			STRING the name of the column Metadata field key metadatafield.status sort by page title with content-name-untokenized
sortdirection	sort direction			ASCENDING DESCENDING
pagesize	Result entries per result page			INTEGER greater 0
fields	narrow down the list of displayed fields per result		all metadata fields of the content results will be shown	A comma separated list of fields. Example: metadatafield.status,metadatafield.contactperson
ceo	The ID of a page or a blogpost to define the context of the request. This is especially useful when using CQL with functions like currentSpace().			INTEGER

Example Request with JavaScript

jQuery.get( contextPath + "/rest/communardo/metadata/latest/filter/1" , {
    query: "global.metadatafield.contactperson:admin",
    pagesize:10,
    sortdirection:"DESCENDING",
    sort:"content-name-untokenized",
	fields: "global.metadatafield.contactperson"
}, function(data) {
    console.log(data);
});

Please note: latest/filter/1 displays the first page of the results. If you have more than 10 results, you will either need to raise the pagesize or go to page 2

Example Response

{
	"pageNo": "1",
	"self": "https://wiki.company.de/rest/communardo/metadata/latest/filter",
	"searchResults": [{
		"pageTitle": "Example",
		"pageUrl": "/display/~admin/Example",
		"pageId": 1234567,
		"contentType": "page",
		"values": [{
			"id": 80,
			"key": "global.metadatafield.contactperson",
			"title": "Contact Person",
			"content": "<a class=\"confluence-userlink user-mention current-user-mention\" data-username=\"admin\" href=\"https://wiki.company.de/display/~admin\" data-linked-resource-id=\"25624936\" data-linked-resource-version=\"1\" data-linked-resource-type=\"userinfo\" data-base-url=\"https://wiki.company.de\">Administrator</a>"
		},
		{
			"id": 81,
			"key": "global.metadatafield.pagestatus",
			"title": "Page Status",
			"content": "Approved"
		},
		{
			"id": 82,
			"key": "global.metadatafield.pagestatusmessage",
			"title": "Page Status Message",
			"content": "nothing to do here"
		}]
	}],
	"pager": {
		"currentPage": 1,
		"pageCount": 1,
		"elementsPerPage": 10,
		"totalElementsCount": 1
	}
}