Feeds API Reference

Feeds are ordered lists of sets and study sessions generated for logged-in users. Using the Quizlet API you are able to view the current logged-in user's recenty studied set, recently created set, class set, and homepage set feeds. Most likely you will not need to use these API endpoints unless you are fully building a mobile version of Quizlet. All feeds require the user to be authenticated and logged-in.

Viewing Feeds

MethodURIDescription
GEThttps://api.quizlet.com/2.0/feed/studiedView the logged-in user's recently studied sets feed
GEThttps://api.quizlet.com/2.0/feed/createdView the logged-in user's recently created sets feed
GEThttps://api.quizlet.com/2.0/feed/homeView the logged-in user's homepage feed (aggregate of all the other feeds)
GEThttps://api.quizlet.com/2.0/classes/CLASS_ID/feedView the set feed for the given class

Expand request fields

Feeds are designed to be loaded in chunks, so loading the user's entire feed may require multiple requests. The basic idea is that each request to load more of the feed requires passing the setIds of each set that has already been loaded so far. In addition, you should pass the minimum timestamp seen by all the sets that have been loaded so far. Passing this minTimestamp will ensure the that displayTimestamp field will be correct. If you don't care about the displayTimestamp field then you don't need to pass a minTimestamp parameter.

Optional Parameters

ParameterTypeDescription
seenSetIds string A list of all the set_ids from all the feed that has loaded so far. These set_ids must passed as a string where each set_ids is separated by a period (.). The reason for this is that set_ids may already contain commas if the user studied a combination of sets.
minTimestamp integer The minimum timestamp seen in all the items that have been loaded so far by the feed. Sending this parameter ensures that the displayTimestamp parameter that gets returned will be accurate.
query string A search string used to filter the feed. Only feed items involving sets whose title or description match the given query string will be returned.
alphabetize boolean If alphabetize is set, then the results will be sorted alphabetically by set name. If this is set then the displayTimestamp field is meaningless

Expand response fields

All feed queries return a response structured as below

Feed Object

FieldTypeDescription
success boolean boolean indicating that the request was successful
finished boolean boolean indicating whether there is still more feed to load
items array array of feed item objects

Feed Item Object

FieldTypeDescription
timestamp integer Deprecated unix timestamp indicating when this feed items was added to Quizlet
set_ids string or integer If the feed item pertains to a combination set, then this will be a string with the set ids of the combination set joined by commas ,. If the feed items pertains to a single set, then this will just be the id of that single set.
item_type string string indicating the type of item that this feed item is wrapping. possibilities include: "set" (for my sets), "class_set" (for sets in a class), and "session" (for recently studied sets)
origin_feed string string indicating which feed this item came from. This field is only useful for the homepage feed, which is the combination of all the other feeds. possibilities include: "my_sets", "recently_studied", and "class"
item_data source item object JSON representation of the source item that this feed items is wrapping. For example, in the case of a recently studied feed item, this will be a session. If it's a set from a class, this will be a class and set. If this is a set the user created, it will just be a raw set.

Source Item Object

The source item is just the standard Quizlet API JSON for whatever object type the given feed item is wrapping, with the exception of class_sets.

More info on the JSON response for sets can be found here: Sets

Classes sets are returned as an object a set and a class field

A sample feed response is shown below:

Sample Feed API Response

{
    "success": true,
    "finished": false,
    "items": [
        {
            "timestamp": 1349748709,
            "set_ids": 13800237,
            "item_type": "set",
            "origin_feed": "my_sets",
            "item_data": {
                "id": 13800237,
                "url": "https://quizlet.com/13800237/flash-cards/",
                "title": "",
                "created_by": "chanind",
                "term_count": 3,
                "created_date": 1349748709,
                "modified_date": 1349749185,
                "has_images": false,
                "subjects": [

                ],
                "visibility": "public",
                "editable": "only_me",
                "has_access": true
            },
            "display_timestamp": "Activity  this week"
        },
        {
            "timestamp": 1349301189,
            "set_ids": "13800215",
            "item_type": "session",
            "origin_feed": "recently_studied",
            "item_data": {
                "mode": "scatter",
                "start_date": 1349301189,
                "finish_date": 1349301199,
                "formatted_score": "6.5 seconds",
                "set": {
                    "id": 13800215,
                    "url": "https://quizlet.com/13800215/hi-flash-cards/",
                    "title": "hi",
                    "created_by": "chanind",
                    "term_count": 3,
                    "created_date": 1348413098,
                    "modified_date": 1349320716,
                    "has_images": false,
                    "subjects": [

                    ],
                    "visibility": "public",
                    "editable": "only_me",
                    "has_access": true
                }
            },
            "display_timestamp": "Activity last week"
        },
        {
            "timestamp": 1346894631,
            "set_ids": 13543617,
            "item_type": "class_set",
            "origin_feed": "class",
            "item_data": {
                "class": {
                    "id": 14680,
                    "name": "PC BEASTS",
                    "set_count": "66",
                    "user_count": "239",
                    "created_date": 1211216360,
                    "has_access": true,
                    "has_discussion": true,
                    "description": "for pc ballas",
                    "admin_only": false,
                    "is_public": false,
                    "has_password": false,
                    "member_add_sets": true
                },
                "set": {
                    "id": 13543617,
                    "url": "https://quizlet.com/13543617/spanish-vocab-animales-trees-and-artillery-flash-cards/",
                    "title": "Spanish vocab: animales, trees and artillery",
                    "created_by": "Scottie814",
                    "term_count": 68,
                    "created_date": 1346894631,
                    "modified_date": 1349320716,
                    "has_images": false,
                    "subjects": [
                        "spanish"
                    ],
                    "visibility": "classes",
                    "editable": "only_me",
                    "has_access": true
                }
            },
            "display_timestamp": false
        },

        ...

        {
            "timestamp": 1341862071,
            "set_ids": "1902372",
            "item_type": "session",
            "origin_feed": "recently_studied",
            "item_data": {
                "mode": "speller",
                "start_date": 1341862071,
                "finish_date": null,
                "formatted_score": null,
                "set": {
                    "id": 1902372,
                    "url": "https://quizlet.com/1902372/la-comida-flash-cards/",
                    "title": "La comida",
                    "created_by": "stmarysspanish6",
                    "term_count": 30,
                    "created_date": 1267063253,
                    "modified_date": 1349320716,
                    "has_images": true,
                    "subjects": [
                        "spanish vocab"
                    ],
                    "visibility": "classes",
                    "editable": "only_me",
                    "has_access": true
                }
            },
            "display_timestamp": "Activity in July 2012"
        }

    ]
}
Create Set