Search API

Perform searches.

Search the Archive Index

GET http://lrr.tvc-16.science/api/search

Search for Archives. You can use the IDs of this JSON with the other endpoints.

Query Parameters

Name	Type	Description
category	string	ID of the category you want to restrict this search to.
filter	string	Search query. You can use the following special characters in it: Quotation Marks ("...") Exact string search. Allows a search term to include spaces. Everything placed inside a pair of quotation marks is treated as a singular term. Wildcard characters are still interpreted as wildcards. Question Mark (?), Underscore (_) Wildcard. Can match any single character. Asterisk (*), Percentage Sign (%) Wildcard. Can match any sequence of characters (including none). Subtraction Sign (-) Exclusion. When placed before a term, prevents search results from including that term. Dollar Sign ($) Add at the end of a tag to perform an exact tag search rather than displaying all elements that start with the term. Only matches tags regardless of search parameters and can be used as an exclusion to ignore misc tags in the search query.
start	string	From which archive in the total result count this enumeration should start. The total number of archives displayed depends on the server-side page size preference. From 0.8.2 onwards, you can use "-1" here to get the full, unpaged data.
sortby	string	Namespace by which you want to sort the results. There are specific sort keys you can use: title if you want to sort by title lastread if you want to sort by last read time. (If Server-side Progress Tracking is enabled) (Default value is title. If you sort by lastread, IDs that have never been read will be removed from the search.)
order	string	Order of the sort, either asc or desc.
newonly	bool	Limit search to new archives only.
untaggedonly	bool	Limit search to untagged archives only.
groupby_tanks	bool	Enable or disable Tankoubon grouping. Defaults to true. When enabled, Tankoubons will show in search results, replacing all the archive IDs they contain.

200

{
    "data": [{
        "arcid": "28697b96f0ac5858be2614ed10ca47742c9522fd",
        "isnew": "none",
        "extension": "zip",
        "tags": "parody:fate grand order,  group:wadamemo,  artist:wada rco,  artbook,  full color",
        "lastreadtime": 1337038234,
        "title": "Fate GO MEMO",
        "pagecount": 40,
        "progress": 0
    }, {
        "arcid": "2810d5e0a8d027ecefebca6237031a0fa7b91eb3",
        "isnew": "none",
        "extension": "rar",
        "tags": "parody:fate grand order,  character:abigail williams,  character:artoria pendragon alter,  character:asterios,  character:ereshkigal,  character:gilgamesh,  character:hans christian andersen,  character:hassan of serenity,  character:hector,  character:helena blavatsky,  character:irisviel von einzbern,  character:jeanne alter,  character:jeanne darc,  character:kiara sessyoin,  character:kiyohime,  character:lancer,  character:martha,  character:minamoto no raikou,  character:mochizuki chiyome,  character:mordred pendragon,  character:nitocris,  character:oda nobunaga,  character:osakabehime,  character:penthesilea,  character:queen of sheba,  character:rin tosaka,  character:saber,  character:sakata kintoki,  character:scheherazade,  character:sherlock holmes,  character:suzuka gozen,  character:tamamo no mae,  character:ushiwakamaru,  character:waver velvet,  character:xuanzang,  character:zhuge liang,  group:wadamemo,  artist:wada rco,  artbook,  full color",
        "lastreadtime": 1337038234,
        "title": "Fate GO MEMO 2",
        "pagecount": 56,
        "progress": 50
    }, {
        "arcid": "4857fd2e7c00db8b0af0337b94055d8445118630",
        "isnew": "none",
        "extension": "pdf",
        "tags": "artist:shirow masamune",
        "lastreadtime": 1337038234,
        "title": "Ghost in the Shell 1.5 - Human-Error Processor vol01ch01",
        "pagecount": 14,
        "progress": 12
    }, {
        "arcid": "e4c422fd10943dc169e3489a38cdbf57101a5f7e",
        "isnew": "none",
        "extension": "epub",
        "tags": "parody: jojo's bizarre adventure",
        "lastreadtime": 0,
        "title": "Rohan Kishibe goes to Gucci",
        "pagecount": 103,
        "progress": 102
    }, {
        "arcid": "e69e43e1355267f7d32a4f9b7f2fe108d2401ebf",
        "isnew": "none",
        "extension": "lzma",
        "tags": "character:segata sanshiro",
        "lastreadtime": 1337038236,
        "title": "Saturn Backup Cartridge - Japanese Manual",
        "pagecount": 12,
        "progress": 0
    }],
    "draw": 0,
    "recordsFiltered": 5,
    "recordsTotal": 5
}

Get Random Archives out of the Index

GET http://lrr.tvc-16.science/api/search/random

Get randomly selected Archives from the given filter and/or category.

Query Parameters

Name	Type	Description
category	string	ID of the category you want to restrict this search to.
filter	string	Search query. This follows the same rules as the queries in /api/search.
count	int	How many archives you want to pull randomly. Defaults to 5. If the search doesn't return enough data to match your count, you will get the full search shuffled randomly.
newonly	bool	Limit search to new archives only.
untaggedonly	bool	Limit search to untagged archives only.
groupby_tanks	bool	Enable or disable Tankoubon grouping. Defaults to true. When enabled, Tankoubons will show in search results, replacing all the archive IDs they contain.

200

{
    "recordsTotal": 4, 
    "data": [
        {
            "arcid": "2810d5e0a8d027ecefebca6237031a0fa7b91eb3",
            "isnew": "none",
            "extension": "rar",
            "tags": "parody:fate grand order,  character:abigail williams,  character:artoria pendragon alter,  character:asterios,  character:ereshkigal,  character:gilgamesh,  character:hans christian andersen,  character:hassan of serenity,  character:hector,  character:helena blavatsky,  character:irisviel von einzbern,  character:jeanne alter,  character:jeanne darc,  character:kiara sessyoin,  character:kiyohime,  character:lancer,  character:martha,  character:minamoto no raikou,  character:mochizuki chiyome,  character:mordred pendragon,  character:nitocris,  character:oda nobunaga,  character:osakabehime,  character:penthesilea,  character:queen of sheba,  character:rin tosaka,  character:saber,  character:sakata kintoki,  character:scheherazade,  character:sherlock holmes,  character:suzuka gozen,  character:tamamo no mae,  character:ushiwakamaru,  character:waver velvet,  character:xuanzang,  character:zhuge liang,  group:wadamemo,  artist:wada rco,  artbook,  full color",
            "lastreadtime": 1337038234,
            "title": "Fate GO MEMO 2",
            "pagecount": 20,
            "progress": 0
        }, {
            "arcid": "4857fd2e7c00db8b0af0337b94055d8445118630",
            "isnew": "none",
            "extension": "pdf",
            "tags": "artist:shirow masamune",
            "lastreadtime": 1337038234,
            "title": "Ghost in the Shell 1.5 - Human-Error Processor vol01ch01",
            "pagecount": 14,
            "progress": 10
        }, {
            "arcid": "e4c422fd10943dc169e3489a38cdbf57101a5f7e",
            "isnew": "none",
            "extension": "epub",
            "tags": "parody: jojo's bizarre adventure",
            "lastreadtime": 0,
            "title": "Rohan Kishibe goes to Gucci",
            "pagecount": 103,
            "progress": 102
        }, {
            "arcid": "e69e43e1355267f7d32a4f9b7f2fe108d2401ebf",
            "isnew": "none",
            "extension": "lzma",
            "tags": "character:segata sanshiro",
            "lastreadtime": 1337033234,
            "title": "Saturn Backup Cartridge - Japanese Manual",
            "pagecount": 12,
            "progress": 0
        }
    ]
}

🔑 Discard Search Cache

DELETE http://lrr.tvc-16.science/api/search/cache

Discard the cache containing previous user searches.

200

{
  "operation": "clear_cache",
  "success": 1
}