{"tools":[{"name":"search","description":"Search Phool for flowers (by common name, scientific name, family or theme), flower decorations and customs, gardens, markets and bloom sites, countries, cities, flower days, experiences, traditions and glossary terms. Start here when unsure which tool fits.","parameters":{"type":"object","properties":{"query":{"type":"string","description":"For example \"marigold\", \"Tagetes\", \"garland\", \"Kyoto\", \"night-blooming\", \"Chelsea\", \"stamen\""},"limit":{"type":"number","description":"1-30, default 10"}},"required":["query"],"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/search"},{"name":"get_flower","description":"The full page for one flower: common and scientific name, family, colours, season, scent, native range, countries and cities, what it looks like, where it comes from, when it blooms, how it is used, varieties, what it means, the countries whose national flower it is, FAQ and sources. Give a slug from another tool, or a common or scientific name.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"tagetes-erecta\" or \"tulip\""},"name":{"type":"string","description":"A common or scientific name, used if slug is not given"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/get_flower"},{"name":"list_flowers","description":"List flowers, filtered by any mix of country, city, region, colour, kind of plant, use, faith, season, botanical family and flower day. Sorted best known first unless sort says otherwise. Use offset to page.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name, e.g. \"IN\" or \"Mexico\""},"city":{"type":"string","description":"City slug from list_cities, or a city name"},"region":{"type":"string","enum":["africa","asia","europe","north-america","south-america","oceania"]},"sort":{"type":"string","enum":["known","name","new","seen"],"description":"known = best documented first, new = newest pages first, seen = most read first"},"limit":{"type":"number","description":"1-100, default 25"},"offset":{"type":"number"},"color":{"type":"string","enum":["red","pink","orange","yellow","white","cream","blue","purple","green","maroon","multi"]},"kind":{"type":"string","enum":["wild","garden","cut","tree","shrub","bulb","climber","orchid","aquatic","succulent","alpine","tropical","herb"],"description":"wild = Wildflowers; garden = Garden flowers; cut = Cut flowers; tree = Flowering trees; shrub = Flowering shrubs; bulb = Bulbs; climber = Climbers; orchid = Orchids; aquatic = Water flowers; succulent = Cactus and succulent flowers; alpine = Alpine flowers; tropical = Tropical flowers; herb = Herbs and useful flowers"},"use":{"type":"string","enum":["wedding","worship","mourning","festival","gift","emblem","home","perfume","edible","medicine","dye"],"description":"wedding = Weddings; worship = Worship and offerings; mourning = Mourning and remembrance; festival = Festivals; gift = Gifts; emblem = National and state emblems; home = Home and everyday; perfume = Perfume and scent; edible = Food and drink; medicine = Traditional medicine; dye = Dye and colour"},"faith":{"type":"string","enum":["hindu","buddhist","christian","muslim","jewish","sikh","jain","other"]},"season":{"type":"string","enum":["spring","summer","monsoon","autumn","winter","all"],"description":"the season it flowers in; season words hold in both hemispheres"},"family":{"type":"string","description":"Botanical family, e.g. \"Asteraceae\""},"day":{"type":"string","description":"Flower day slug or name from list_flower_days, e.g. \"diwali\""}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_flowers"},{"name":"get_decoration","description":"The full page for one way of decorating with flowers or one flower custom (ikebana, garland, lei, wreath, flower carpet, pookalam, flower parade, offering, garden style): what it is, where it comes from, how it is made, which flowers are used, when it is used and what it means.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"ikebana\""},"name":{"type":"string","description":"A name, used if slug is not given"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/get_decoration"},{"name":"list_decorations","description":"List flower decorations and customs, filtered by country, city, region, kind, use (wedding, worship, mourning, festival...), faith, the flower used, and flower day.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name, e.g. \"IN\" or \"Mexico\""},"city":{"type":"string","description":"City slug from list_cities, or a city name"},"region":{"type":"string","enum":["africa","asia","europe","north-america","south-america","oceania"]},"sort":{"type":"string","enum":["known","name","new","seen"],"description":"known = best documented first, new = newest pages first, seen = most read first"},"limit":{"type":"number","description":"1-100, default 25"},"offset":{"type":"number"},"kind":{"type":"string","enum":["arrangement","garland","worn","ground","display","offering","craft","art","gardenstyle","custom"],"description":"arrangement = Arrangements and bouquets; garland = Garlands and wreaths; worn = Flowers that are worn; ground = Carpets and floor patterns; display = Parades, floats and big displays; offering = Offerings and rites; craft = Flower crafts; art = Flowers in art and design; gardenstyle = Garden styles; custom = Customs, festivals and the trade"},"use":{"type":"string","enum":["wedding","worship","mourning","festival","gift","emblem","home","perfume","edible","medicine","dye"]},"faith":{"type":"string","enum":["hindu","buddhist","christian","muslim","jewish","sikh","jain","other"]},"flower":{"type":"string","description":"A flower it is made with, lower-case common name, e.g. \"marigold\""},"day":{"type":"string","description":"Flower day slug or name"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_decorations"},{"name":"get_place","description":"The full page for one flower place: a botanical garden, flower garden, flower market, bloom field or show site, with what it is, its history, what to see, when to go, its coordinates and its official website when known.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"keukenhof\""},"name":{"type":"string","description":"A name, used if slug is not given"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/get_place"},{"name":"list_places","description":"List flower places to visit, filtered by country, city, region, kind and the month to go.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name, e.g. \"IN\" or \"Mexico\""},"city":{"type":"string","description":"City slug from list_cities, or a city name"},"region":{"type":"string","enum":["africa","asia","europe","north-america","south-america","oceania"]},"sort":{"type":"string","enum":["known","name","new","seen"],"description":"known = best documented first, new = newest pages first, seen = most read first"},"limit":{"type":"number","description":"1-100, default 25"},"offset":{"type":"number"},"kind":{"type":"string","enum":["botanic","flowergarden","market","field","event"],"description":"botanic = Botanical gardens; flowergarden = Flower gardens and parks; market = Flower markets; field = Bloom fields and wild places; event = Festivals and shows"},"month":{"type":"number","description":"1-12: places whose page names this month as a time to visit"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_places"},{"name":"random_flower","description":"One published flower chosen at random, in full. Good for discovery.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/random_flower"},{"name":"flower_of_the_day","description":"The flower featured on the Phool home page today.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/flower_of_the_day"},{"name":"in_flower_today","description":"The live picture for a date: flower festivals, shows, bloom seasons and flower-giving days that are on now or start within the next few days, each with its flowers; what is in bloom this month north and south of the equator; experiences in season; and the flower of the day.","parameters":{"type":"object","properties":{"date":{"type":"string","description":"A day as YYYY-MM-DD; default today (UTC)"},"days_ahead":{"type":"number","description":"0-60, default 10"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/in_flower_today"},{"name":"in_bloom","description":"Flowers in bloom in a month, for the northern or southern hemisphere, each with a note on where people meet it and a link to its page when written.","parameters":{"type":"object","properties":{"month":{"type":"number","description":"1-12, default the current month"},"hemisphere":{"type":"string","enum":["north","south"],"description":"default north"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/in_bloom"},{"name":"get_flower_day","description":"One day or season of the flower calendar in full: a festival, parade, show, bloom season, holy day or flower-giving day, with who keeps it and where, when it next falls, and the flowers that belong to it.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"chelsea-flower-show\""},"name":{"type":"string","description":"A name, used if slug is not given"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/get_flower_day"},{"name":"list_flower_days","description":"Every day and season of the flower calendar in the year ahead, soonest first, with the date each next falls on. Optionally for one kind, faith or country.","parameters":{"type":"object","properties":{"kind":{"type":"string","enum":["festival","show","bloom","religious","national","remembrance","giving"]},"faith":{"type":"string","enum":["hindu","buddhist","christian","muslim","jewish","sikh","jain","other"]},"country":{"type":"string","description":"ISO code or English name"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_flower_days"},{"name":"list_experiences","description":"Things to do with flowers in a named city: bloom seasons and flower fields, flower markets, gardens worth a journey, flower routes and hands-on workshops, each with the months to go. Filter by country, city, kind and month. The flower equivalent of a food tour.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name"},"city":{"type":"string","description":"City name, e.g. \"Kyoto\""},"kind":{"type":"string","enum":["bloom","market","garden","route","handson"],"description":"bloom = Bloom seasons and flower fields; market = Flower markets; garden = Gardens worth a journey; route = Flower routes and walks; handson = Workshops and hands-on"},"month":{"type":"number","description":"1-12; default any month"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_experiences"},{"name":"get_experience","description":"One flower experience in full: what it is, where, the months to go, practical tips and the flowers you will see. Give a slug from list_experiences, or a name.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug from list_experiences"},"name":{"type":"string","description":"A name, used if slug is not given"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/get_experience"},{"name":"list_countries","description":"Every country with the number of flowers, decorations and places on Phool that belong to it, its national flower where known, and whether its flora overview is written. Optionally for one region.","parameters":{"type":"object","properties":{"region":{"type":"string","enum":["africa","asia","europe","north-america","south-america","oceania"]}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_countries"},{"name":"get_country","description":"One country in full: its national flower, an overview of its plant life (regions, notable flowers, seasons, uses, threats), the season it is in now, how many flowers, decorations and places Phool has for it, its best known ones, its flower cities, experiences, traditions and flower days.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name, e.g. \"JP\" or \"Ethiopia\""}},"required":["country"],"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/get_country"},{"name":"list_cities","description":"Cities and regions that pages on Phool are tied to, with how many each has, optionally for one country. Use the slug with list_flowers, list_decorations or list_places.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name"},"limit":{"type":"number","description":"1-400, default 100"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_cities"},{"name":"national_flowers","description":"The national flower or floral emblem of each country, marked official or unofficial, optionally for one country.","parameters":{"type":"object","properties":{"country":{"type":"string","description":"ISO code or English name"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/national_flowers"},{"name":"list_traditions","description":"The flower traditions Phool explains: arranging, garlands and wreaths, flower carpets and parades, offerings and rites, giving and meaning, viewing, the flower trade and garden traditions.","parameters":{"type":"object","properties":{"kind":{"type":"string","enum":["arrange","garland","ground","rite","giving","viewing","trade","garden"],"description":"arrange = Arranging and floral design; garland = Garlands, wreaths and flowers that are worn; ground = Carpets, floats and big displays; rite = Offerings, weddings and farewells; giving = Giving and meaning; viewing = Viewing and flower tours; trade = Markets, growers and the trade; garden = Garden traditions"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/list_traditions"},{"name":"get_tradition","description":"One flower tradition in full: what it is, where it is kept, how it is made or done, how to take part, the etiquette, and the flowers that belong to it. Give a slug from list_traditions, or a name.","parameters":{"type":"object","properties":{"slug":{"type":"string","description":"Slug such as \"ikebana\""},"name":{"type":"string","description":"A name, used if slug is not given"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/get_tradition"},{"name":"define_term","description":"A plain-language definition of a word used about flowers, botany, floristry and decoration (stamen, bract, cultivar, ikebana, kenzan, corsage, attar, vase life...).","parameters":{"type":"object","properties":{"term":{"type":"string"}},"required":["term"],"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/define_term"},{"name":"latest_news","description":"Recent headlines about flowers, gardens, flower shows, floristry and the flower trade, with outlet and link. Phool does not write these stories.","parameters":{"type":"object","properties":{"limit":{"type":"number","description":"1-40, default 12"}},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/latest_news"},{"name":"stats","description":"How many flowers, decorations and places Phool covers, by region, colour, kind, use and faith, and how many are still waiting to be written. Use this to judge completeness.","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/stats"},{"name":"site_info","description":"A publication card for Phool: name, tagline, publisher, network, topics, catalogue counts, feeds, MCP and API addresses, ad slots and contact. For directories and for ClearTrust's network tools (CPN, Footfall, Yieldo, Assay).","parameters":{"type":"object","properties":{},"additionalProperties":false},"url":"https://phool.cleartrust.cc/api/v1/site_info"}]}