NYnypl
discovery

List subjects and counts.

Changed on

Browse subjects starting by a prefex (can be a whole term or a letter)

/discovery/browse/subjects?search_scope=starts_with&q=M

Look up exact subjects

/discovery/browse/subjects?q=Manhattan

Or look up subjects containing a substring

/discovery/browse/subjects?search_scope=has&q=Africa

get/v0.1/discovery/subjects/browse

Request

Query parameters

qstring

Term to match for a whole-subject, prefix or substring search.

pageinteger

Page number to return

per_pageinteger

Number of results to return

sort'relevance' | 'preferredTerm' | 'count'

Specify how to order results (relevance, preferredTerm, count)

sort_direction'asc' | 'desc'

Override the default direction for the current sort (asc, desc). Default depends on the field. (preferredTerm defaults to asc, count defaults to desc, relevance is fixed desc)

search_scope'has' | 'starts_with'

Specify how to search across the subject index. has will search for substrings within a subject term. starts_with returns the list of subjects beginning with the query term.

Response

An array of subjects

@type'subjectList'
pageinteger
perPageinteger

Changes