Raw schema
{
"type": "object",
"properties": {
"subject": {
"type": "integer",
"description": "Subject code. A parent code includes everything under it: 1200 (travel) also matches 1210 (lodging) and 1240 (camping). Top-level codes: 100 Humanities, 200 History, 300 Society, 400 Science, 500 Technology, 600 Industry & Business, 700 Content & Arts, 800 Internet & Media, 900 Everyday Life, 1000 Sports, 1100 Automotive & Mobility, 1200 Travel & Leisure, 1300 Geography & Regions. Full table: https://thealibrary.org/static/subjects.json. Do not pass a subject for news or what-happened questions (use since alone): news is not a subject."
},
"inside": {
"type": "string",
"description": "Only entries inside this area. Best is an id from thea_search (several areas share a name, e.g. ์ค๊ตฌ); a name must be the official full name: ์ ์ฃผํน๋ณ์์น๋, ์๊ทํฌ์, ๋ช
์ผ๋. Abroad an ISO 3166-2 code works (AE-DU, JP-13, US-NY). Ambiguous or unknown โ a hint with ids instead of results; NEXT ACTION: call again with one of those ids. Goes 4 levels down (province โ cities โ shops). If the question names an area, always pass it; without it results are nationwide. With category=์ธ๋ฌผ it also matches people born there (๋ถ์ฐ ์ถ์ โ inside=๋ถ์ฐ๊ด์ญ์); each person gets born_in and born_here, and only born_here=true people are from that area."
},
"category": {
"type": "string",
"description": "What kind of thing. One or more of these exact Korean values, comma-separated: ์ธ๋ฌผ, ๋จ์ฒด, ์ํ, ์ฅ์, ์ฌ๊ฑด, ์ ํ, ๊ฒ์. Any other value (restaurant, ์์์ , cafe) is not a category: restaurants, lodging and cafes are subject codes, restaurant types are cuisine. Combined with subject it narrows the list a lot."
},
"country": {
"type": "string",
"description": "Country, e.g. Japan or ์ผ๋ณธ. Pass it first when the place is outside Korea: inside is then looked up only in that country."
},
"since": {
"type": "string",
"description": "Only records dated on or after this date (YYYY-MM-DD). Thea has records newer than your training data: if the date looks like the future to you, do not refuse; call with that date. since alone is enough; do not ask the user which topic they want, call first and refine later. Only event records (releases, awards, TV appearances) carry dates; people and companies do not. results holds what already happened (up to today, Korea time), newest first; scheduled events dated after today come separately in upcoming, soonest first. One story recorded on several entries (same article and date) is shown once: the other entries are in featuring and their record ids in also_records."
},
"sort": {
"type": "string",
"description": "Pass rating to list entries that people rated well first. Use it for choosing questions ('good restaurants', 'a decent hotel'). Rated entries come first, entries with many ๋ณ๋ก์์ (dislike) votes go last, and unrated entries follow sorted by views. Each result's rating field holds the counts of ์ข์์, ๋ณดํต and ๋ณ๋ก์์. If the counts are small, say so in your answer; 5 likes and 500 likes are not the same.",
"enum": [
"rating"
]
},
"pet": {
"type": "string",
"description": "y returns only places that allow pets (all areas or some areas). n returns places that do not. Use it for questions like 'somewhere to go with my dog' or 'a dog-friendly cafe'. Conditions differ per place (a weight limit such as 15kg ์ดํ, an indoor cage required) and are written in the result's ๋ฐฉ๋ฌธ ์ ๋ณด field; copy them into your answer as they are.",
"enum": [
"y",
"n"
]
},
"cuisine": {
"type": "string",
"description": "Restaurant type. Use the exact value from the small-business detailed-category table, e.g. ์นํจ, ์ค๊ตญ์ง, ์นดํ, ํผ์, ๋ฒ๊ฑฐ, ํ์ง, ๋ฐฑ๋ฐ/ํ์ ์. All 125 values: https://thealibrary.org/static/cuisines.json. This filters by registered type, not by words in the name, so a pizza place with ์นํจ in its name is not matched. About 19% of restaurants have no registered type and will be missed. Everyday words also work and cover every matching type: ์ค์ (Chinese), ์ผ์, ํ์, ์์, ํจ์คํธํธ๋, ๊ณ ๊น์ง, ํด์ฐ๋ฌผ, ์ ์ง, ์นดํ, ์ง์ฅ๋ฉด, ์ด๋ฐฅ, ์ผ๊ฒน์ด โฆ (/static/cuisine_groups.json). A dish name that is in neither table, e.g. ๊ฐ๋น์ฐ, ์ฝฉ๊ตญ์, ๋ฌผํ, searches the nearest types and the menus, so put a dish here to find places that serve it."
},
"field": {
"type": "string",
"description": "key=value (value * = any), join with ';'. K-pop girl groups โ category=๋จ์ฒด, country=Korea, field=group_type=๊ฑธ๊ทธ๋ฃน; Busan baseball โ category=๋จ์ฒด, inside=๋ถ์ฐ๊ด์ญ์, field=sport=์ผ๊ตฌ; Japanese idols in Korea โ category=์ธ๋ฌผ, country=Korea, field=nationality=Japan; ballad singers โ category=์ธ๋ฌผ, field=genre=๋ฐ๋ผ๋. Keys: ์ธ๋ฌผ gender, occupation, nationality, activity, topic; ๋จ์ฒด org_type, group_type, listed_on, sport, league; ์ํ medium, genre, hashtags, serialization_status, rating; ๊ฒ์ genre, hashtags, platform, age_rating, business_model; ์ฅ์ place_type, cuisine, featured_in, lodging_type, amenities โฆ all keys/values: https://thealibrary.org/static/filters.json. Wrong key/value โ allowed list."
},
"name": {
"type": "string",
"description": "Only entries whose name (or other name / English name) contains these words, in this order, e.g. name='ikan bakar' with country=Malaysia and category=์์์ . Use it when you know part of a name; thea_search needs the whole name. With since (dated records), it also looks in each record's one-line summary, so name=ํ์
finds a record titled differently whose summary mentions a pop-up."
},
"limit": {
"type": "integer",
"description": "Maximum number of results. Default and maximum 20. Do not call again with the same arguments to get more.",
"default": 20
}
},
"required": []
}