Set Search API Reference

You can search Quizlet's 87,679,698 flashcard sets by title/subject query and creator.

There is also a shortcut to view any user's sets (i.e. https://api.quizlet.com/2.0/users/USERNAME/sets).

Searching For Sets

MethodURIDescription
GEThttps://api.quizlet.com/2.0/search/setsGeneral way to search for sets. Returns minimal information about sets, like their title and creator.
GEThttps://api.quizlet.com/2.0/users/USERNAME/setsView full details of a specific user's sets. See Users API for details.
GEThttps://api.quizlet.com/2.0/sets/SET_IDView full details of a single set. See the Sets API for details.

Permissions

  • When used with a Client ID, only public sets will be returned.
  • When we receive a user-authorized token, both public sets and sets the user has access to will be returned.

Expand request fields

Optional Parameters

While all of the parameters below are optional, at least one of q or creator must be provided. Parameters specified are used as an "AND" operation, e.g. "q=spanish&creator=jorge" will return spanish sets created by the user jorge.

0 or 1. When 1, returns results with partial matching for autocompleting.
ParameterTypeDescriptionDefault
qstringReturns sets with titles and/or subjects that match your query.-
creatorstringReturns sets created by the specified Quizlet user.-
images_onlyboolean0 or 1. When 1, limits results to sets with images only.0
autocompleteboolean0
modified_sincetimestampLimits results to sets that have been modified since the specified Unix timestamp.-
sortstringDeprecated The field to sort by. This will cause bad results and should never be used-
pageintegerThe page of the result set to display.1
per_pageintegerThe number of sets to display per page (must be between 1 and 50).30

Expand response fields

Result object

FieldTypeDescription
total_results integer The total number of sets matching your search query.
total_pages integer The total number of pages for your query.
image_set_count integer The number of sets that contain images in the results.
page integer Shows which page of results you are viewing. 30 results are shown per page by default (adjust the per_page parameter to change that).
sets array Array of set objects.

Set object

For full details of the set object, see the Sets API page.

All sets returned in search results only display minimal information, in particular, the terms, languages, has_discussion and description will be missing.

You can view the full set details by viewing sets one at time.

Example output

Output for https://api.quizlet.com/2.0/search/sets?q=french%20animals (Note: for brevity, only one set is displayed below):

Header
HTTP/1.1 200 OK
Content-Type: application/javascript
Body
{
  "total_results": 60,
  "total_pages": 2,
  "image_set_count": 35,
  "page": 1,
  "sets": [
	{
	  "id": 6009523,
	  "url": "http:\/\/quizlet.com\/6009523\/french-animals-30-flash-cards\/",
	  "title": "french animals 3.0",
	  "created_by": "catchdave",
	  "term_count": 13,
	  "created_date": 1310497102,
	  "modified_date": 1310497363,
	  "has_images": true,
	  "subjects": [
	    "french",
	    "animals"
	  ]
 	},
    ...
  ]
}

Try it out now!

In order to test out the API you must have an API developer key.
First log in or sign up.

Differences From API v1.0

You can perform all the same queries as you could in 1.0, but the format is slightly different.

The only thing that you can't search for is multiple IDs at the same time.

Lastly, there is no equivalent of the extended parameter for searches in the API 2.0. Sets will be displayed either with minimal information or with full details depending on the endpoint you use.

Sets returned with minimal details

Sets will be displayed with minimal information, which means without the terms (like extended=off) when:

  • Sets returned from any search URL (i.e. https://api.quizlet.com/2.0/search/) will always be minimal.
  • A user's sets being viewed with as part of their profile (i.e. https://api.quizlet.com/2.0/users/USERNAME) will display only minimal information about sets.

Sets returned with all details, including terms

Sets will be displayed with full information, including the terms (like extended=on) when:

  • Single sets being viewed (i.e. https://api.quizlet.com/2.0/sets/SET_ID) will always display full details.
  • When viewing the sets section of a user (i.e. https://api.quizlet.com/2.0/users/USERNAME/sets) will always display full details.

Mapping searches from version 1.0

Search API 1.0 API 2.0
Get a single set by ID /1.0/sets?q=ids:SET_ID /2.0/sets/SET_ID
Search for a specific user's sets /1.0/sets?q=creator:USERNAME /2.0/users/USERNAME/sets or /2.0/search/sets?creator=USERNAME
Search by title and subjects /1.0/sets?q=SEARCH_QUERY /2.0/search/sets?q=SEARCH_QUERY
Search by title and subjects in a user's sets only /1.0/sets?q=SEARCH_QUERY+creator:USERNAME /2.0/search/sets?q=SEARCH_QUERY&creator=USERNAME