Maximum Topics
Syntax
The query expansion parameter uses the following syntax:
s.rec.topic.max=<integer>
A query string may contain only one s.rec.topic.max parameter. The default value for this parameter is 0.
Function
The maximum topics parameter defines the maximum number of topics that will be returned in the search result. Currently, this parameter only supports 0 or 1 as input.
The response will contain the following items:
- Encyclopedia resource
- Suggested librarian
- Recommended topics
- Recommended research guides
Example – Using the s.rec.topic.max parameter
This query string enables the topic service to return a maximum of 1 topic for the search:
s.q=heart+attack&s.rec.topic.max=1
Response
The following is an example topic recommendations response section:
"topicRecommendations": [ { "title": "Music", "snippet": "Music is an art form whose medium is sound and silence. Its common elements are pitch (which governs melody and harmony), rhythm (and its associated concepts tempo, meter, and articulation), dynamics, and the sonic qualities of timbre and texture.", "score": 4.955859, "sourceName": "wikipedia", "sourceLink": "http://example.summon.serialssolutions.com/2.0.0/link/topicrec/AAA..., "relevantAuthors": [], "relatedTopics": [ { "topicId": "Folk_music-en", "title": "Folk music" }, { "topicId": "Soul_music-en", "title": "Soul music" }, { "topicId": "Native_American_music-en", "title": "Native American music" } ], "researchGuides": [ { "title": "Browse Databases by Subject. Recommended Databases for Music. Recommended Databases", "link": "http://example.summon.serialssolutions.com/2.0.0/link/topicrec/AAA...", "author": "Laura Williams" }, { "title": "Music", "link": "http://example.summon.serialssolutions.com/2.0.0/link/topicrec/AAA...", "author": "Laura Williams" }, { "title": "Music", "link": "http://example.summon.serialssolutions.com/2.0.0/link/topicrec/AAA...", "author": "Laura Williams" } ], "librarianContactInfo": { "imageURL": "//libapps.s3.amazonaws.com/accounts/53488/profiles/45497/IMG_1761.jpg", "name": "Laura Williams", "email": "mailto:laura.williams@duke.edu" } } ],