Search
Search Service
Web services for searching content, people, and places.
Create Search Query
POST /search/monitorInternal REST endpoint for logging Jive user interactions with the Search UI in JSON format
Get Contents
GET /search/contentsSearch for and return content objects that match the specified filter criteria, in the specified order.
This service supports the following filters. Only one filter of each type is allowed. Parameters, when used, should be wrapped in parentheses, and multiple values separated by commas. See the examples for clarification.
| Filter | Params | Example |
|---|---|---|
| after | Select content objects last modified after the specified date/time. | ?filter=after(2012-01-31T19:13:29.851+0000) |
| author | Select content objects authored by the specified person. The parameter value must be either a full or partial (starting with "/people/") URI for the desired person. | ?filter=author(/people/4321) |
| before | Select content objects last modified before the specified date/time. | ?filter=after(2012-01-31T19:13:29.851+0000) |
| morelike | Select content objects that are similar to the specified content object. | ?filter=morelike(/content/1234) |
| place | Select content objects that are contained in the specified place or places. The parameter value(s) must be full or partial (starting with "/places/") URI for the desired place(s). | ?filter=place(/places/2222,places/3333) |
| search | One or more search terms, separated by commas. This filter is required. You must escape any of the following special characters embedded in the search terms: comma (","), backslash ("\"), left parenthesis ("("), and right parenthesis (")"), by preceding them with a backslash. Remember to URL encode any special character. | ?filter=search(test,report) or ?filter=search(10%2C000) |
| subjectonly |
Optional boolean value indicating whether or not to limit search results
to only content objects whose subject matches the search keywords. Defaults to true.
|
?filter=subjectonly(true) or ?filter=subjectonly |
| type | One or more object types of desired content types separated by commas. | ?filter=type(document,post) |
This service supports the following sort types.
| Sort | Description |
|---|---|
| relevanceDesc | Sort by relevance, in descending order. This is the default sort order. |
| updatedAsc | Sort by the date this content object was most recently updated, in ascending order. |
| updatedDesc | Sort by the date this content object was most recently updated, in descending order. |
The returned list may contain a mixture of content object entities of various types. On any given
content object entity, use the type field to determine the type of that particular content object.
Query Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| filter | Object[] | false | Filter expression(s) used to select matching results |
| collapse | Boolean | false | Flag indicating that search results should be "collapsed" if they have the same parent |
| sort | String | false | Sort expression used to order results |
| startIndex | Integer | false | Zero-relative index of the first matching result to return |
| count | Integer | false | Maximum number of matches to return |
| origin | String | false | Client that sent this search request |
| fields | String | false | Fields to include in returned matches |
Retrieves:
Return Status:
| HTTP Status Code | Description |
|---|---|
| 200 (OK) | Request was successful |
| 400 (Bad Request) | An input parameter is missing or malformed |
| 403 (Forbidden) | You attempted to reference an object that you do not have access to |
| 404 (Not Found) | You attempted to reference an object that does not exist |
Get People
GET /search/peopleSearch for and return people that match the specified filter criteria, in the specified order.
This service supports the following filters. Only one filter of each type is allowed. Parameters, when used, should be wrapped in parentheses, and multiple values separated by commas. See the examples for clarification.
| Filter | Params | Example |
|---|---|---|
| lastProfileUpdate | One or two timestamps in ISO-8601 format. If one timestamp is specified, all persons who have updated their profile since that timestamp will be selected. If two timestamps are specified, all persons who updated their profile in the specified range will be selected. | ?filter=lastProfileUpdate(2012-01-31T22:46:12.044%2B0000,2012-12-03T22:46:12.044%2B0000) |
| nameonly |
Optional boolean value indicating whether or not to limit search results
to only people that match by name. Without a filter, defaults to false.
|
?filter=nameonly(true) or ?filter=nameonly |
| search | One or more search terms, separated by commas. This filter is required. You must escape any of the following special characters embedded in the search terms: comma (","), backslash ("\"), left parenthesis ("("), and right parenthesis (")") by preceding them with a backslash. Remember to URL encode any special character. | ?filter=search(test,report) or ?filter=search(10%2C000) |
| tag | One or more tag values, separated by commas. A match on any of the tags will cause this person to be returned. | ?filter=tag(sales,performance) |
| title |
Single value to match against the Title profile field.
|
?filter=title(Marketing+Manager) |
| updated | One or two timestamps in ISO-8601 format. If one timestamp is specified, all persons updated since that timestamp will be selected. If two timestamps are specified, all persons updated in the specified range will be selected. | ?filter=updated(2012-01-31T22:46:12.044%2B0000,2012-12-03T22:46:12.044%2B0000) |
| view-content | Only persons that can view the requested content will be selected. Since: 3.4 | ?filter=view-content(/content/1234) |
This service supports the following sort types.
| Sort | Description |
|---|---|
| lastProfileUpdateAsc | Sort by last profile update date/time in ascending order. |
| lastProfileUpdateDesc | Sort by last profile update date/time in descending order. |
| relevanceDesc | Sort by relevance, in descending order. This is the default sort order. |
| statusLevelDesc | Sort by status level in descending order. |
| updatedAsc | Sort by the date this person was most recently updated, in ascending order. |
| updatedDesc | Sort by the date this person was most recently updated, in descending order. |
Query Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| filter | Object[] | false | Filter expression(s) used to select matching results |
| viewContentURI | String | false | Optional. viewContent inside of Jive that is inside of Person will indicate if the user can see the requested content. Since 3.5 |
| sort | String | false | Sort expression used to order results |
| startIndex | Integer | false | Zero-relative index of the first matching result to return |
| count | Integer | false | Maximum number of matches to return |
| origin | String | false | Client that sent this search request |
| fields | String | false | Fields to include in returned matches |
Retrieves:
Return Status:
| HTTP Status Code | Description |
|---|---|
| 200 (OK) | Request was successful |
| 400 (Bad Request) | An input parameter is missing or malformed |
| 403 (Forbidden) | You attempted to reference an object that you do not have access to |
| 404 (Not Found) | You attempted to reference an object that does not exist |
Get Places
GET /search/placesSearch for and return places that match the specified filter criteria, in the specified order.
This service supports the following filters. Only one filter of each type is allowed. Parameters, when used, should be wrapped in parentheses, and multiple values separated by commas. See the examples for clarification.
| Filter | Params | Example |
|---|---|---|
| company |
Single value to match against the Company profile field.
|
?filter=company(Jive+Software) |
| department |
Single value to match against the Department profile field.
|
?filter=department(Engineering) |
| hire-date | One or two dates in ISO-8601 format. One date indicates selection of all people hired on or after the specified date. Two dates indicates selection of all people hired between the specified dates. | ?filter=hire-date(2012-01-31T22:46:12.044%2B0000,2012-12-03T22:46:12.044%2B0000) |
| include-disabled | Optional boolean value indicating whether disabled users should be returned (without a filter, defaults to false). | ?filter=include-disabled or ?filter=include-disabled(true) |
| include-external | Optional boolean value indicating whether external (non-person) users should be returned (without a filter, defaults to false). | ?filter=include-external or ?filter=include-external(true) |
| include-online | Optional boolean value indicating whether only online users should be returned (without a filter, defaults to false). | ?filter=include-online or ?filter=include-online(true) |
| include-partner | Optional boolean value indicating whether partner (external contributor) users should be returned (without a filter, defaults to true). | ?filter=include-partner(false) |
| location |
Single value to match against the Location profile field.
|
?filter=location(Portland) |
| nameonly |
Optional boolean value indicating whether or not to limit search results
to only places whose name matches the search keywords. Defaults to true.
|
?filter=nameonly(true) or ?filter=nameonly |
| published | One or two timestamps in ISO-8601 format. If one timestamp is specified, all persons created since that timestamp will be selected. If two timestamps are specified, all persons created in the specified range will be selected. | ?filter=updated(2012-01-31T22:46:12.044%2B0000,2012-12-03T22:46:12.044%2B0000) |
| search | One or more search terms, separated by commas. This filter is required. You must escape any of the following special characters embedded in the search terms: comma (","), backslash ("\"), left parenthesis ("("), and right parenthesis (")") by preceding them with a backslash. This field is required on a search. Remember to URL encode any special character. | ?filter=search(test,report) or ?filter=search(10%2C000) |
| type | One or more object types of desired contained places (blog, group, project, space) separated by commas. | ?filter=type(blog,project) |
This service supports the following sort types.
| Sort | Description |
|---|---|
| dateJoinedAsc | Sort by joined date in ascending order. |
| dateJoinedDesc | Sort by joined date in descending order. |
| firstNameAsc | Sort by first name in ascending order. |
| lastNameAsc | Sort by last name in ascending order. |
| relevanceDesc | Sort by relevance, in descending order. This is the default sort order. |
| updatedAsc | Sort by the date this place was most recently updated, in ascending order. |
| updatedDesc | Sort by the date this place was most recently updated, in descending order. |
The returned list may contain a mixture of place entities of various types. On any given place entity,
use the type field to determine the type of that particular place.
Query Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| filter | Object[] | false | Filter expression(s) used to select matching results |
| collapse | Boolean | false | Flag indicating that search results should be "collapsed" if they have the same parent |
| sort | String | false | Sort expression used to order results |
| startIndex | Integer | false | Zero-relative index of the first matching result to return |
| count | Integer | false | Maximum number of matches to return |
| origin | String | false | Client that sent this search request |
| fields | String | false | Fields to include in returned matches |
Retrieves:
Return Status:
| HTTP Status Code | Description |
|---|---|
| 200 (OK) | Request was successful |
| 400 (Bad Request) | If an input parameter is missing or malformed |
| 403 (Forbidden) | If you attempt to reference an object that you do not have access to |
| 404 (Not Found) | If you attempt to reference an object that does not exist |