{"info":{"_postman_id":"e6c2a0f0-8657-42fd-aeac-e652918e1597","name":"FlavorDB API","description":"

The flavor is an expression of olfactory and gustatory sensations experienced through a multitude of chemical processes triggered by molecules. Beyond their key role in defining taste and smell, flavor molecules also regulate metabolic processes with consequences to health. Such molecules present in natural sources have been an integral part of human history with limited success in attempts to create synthetic alternatives. Given their utility in various spheres of life such as food and fragrances, it is valuable to have a repository of flavor molecules, their natural sources, physicochemical properties, and sensory responses.

FlavorDB comprises of 25595 flavor molecules representing an array of tastes and odors. Among these 2254 molecules are associated with 936 natural ingredients belonging to 34 categories. The dynamic, user-friendly interface of the resource facilitates exploration of flavor molecules for divergent applications: finding molecules matching a desired flavor or structure; exploring molecules of an ingredient; discovering novel food pairings; finding the molecular essence of food ingredients; associating chemical features with a flavor and more. Data-driven studies based on FlavorDB can pave the way for an improved understanding of flavor mechanisms.

This API allows you to access FlavorDB. To request data from any endpoint you must have an authentication token. You can request the authentication token by providing username and password at the API Token Endpoint.

To get the username and password for using the APIs, you can send email bagler@iiitd.ac.in

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"13496956","collectionId":"e6c2a0f0-8657-42fd-aeac-e652918e1597","publishedId":"TVev55ME","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-11-22T21:54:54.000Z"},"item":[{"name":"Entity","item":[{"name":"Food Pairing Analysis","id":"81de41c3-a302-4d33-af01-a8f476bdd511","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://cosylab.iiitd.edu.in/api/foodPairingAnalysis/{{entity_id}}","description":"

Get the best paired list of entities with the current entity.

To get the autocomplete suggestions for entities based on the string passed in the request\nUse either name or category name as parameter

Optional

\n","type":"text/plain"},"key":"name","value":"{{entity_name_ac}}"},{"description":{"content":"

Optional

\n","type":"text/plain"},"key":"category","value":"{{category_name_ac}}"}],"variable":[]}},"response":[{"id":"540e095a-c005-4f54-852d-0335c412b473","name":"Entity AutoComplete Example (category)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://cosylab.iiitd.edu.in/api/entity/entityautocomplete?category={{category_name_ac}}","host":["https://cosylab.iiitd.edu.in/api"],"path":["entity","entityautocomplete"],"query":[{"key":"name","value":"{{entity_name_ac}}","description":"Optional","disabled":true},{"key":"category","value":"{{category_name_ac}}","description":"Optional"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Rate-Limit-Remaining","value":"49"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Sun, 22 Nov 2020 21:46:34 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"[\n \"bakery\",\n \"vegetable-cabbage\"\n]"},{"id":"b906e7a4-340b-4b3f-b51f-92fce5a3ca09","name":"Entity AutoComplete Example (name)","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://cosylab.iiitd.edu.in/api/entity/entityautocomplete?name={{entity_name_ac}}","host":["https://cosylab.iiitd.edu.in/api"],"path":["entity","entityautocomplete"],"query":[{"key":"name","value":"{{entity_name_ac}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Rate-Limit-Remaining","value":"49"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Sun, 22 Nov 2020 20:28:34 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"[\n \"Bread\",\n \"Rye Bread\",\n \"Wheaten Bread\",\n \"White Bread\",\n \"Wholewheat Bread\",\n \"Crispbread\",\n \"Breakfast cereal\",\n \"Breadfruit\",\n \"Breadnut tree seed\",\n \"Carp bream\",\n \"Frybread\",\n \"Breakfast sandwich\",\n \"Pita bread\",\n \"Other bread product\",\n \"Piki bread\",\n \"Oat bread\",\n \"Potato bread\",\n \"Cornbread\",\n \"Multigrain bread\",\n \"Rice bread\",\n \"Raisin bread\"\n]"}],"_postman_id":"3a26aa27-8f2c-48d2-a4a7-0362171f4c6c"},{"name":"ALL Entity Details","id":"81e4e7f5-78cc-41ea-9504-1dfece346b91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://cosylab.iiitd.edu.in/api/entity/getentities?category={{category_name}}&name={{entity_name}}","description":"

To get the details of all the entities in the database.

String (name or partial name) (Optional)

\n","type":"text/plain"},"key":"category","value":"{{category_name}}"},{"description":{"content":"

String (name or partial name) (Optional)

\n","type":"text/plain"},"key":"name","value":"{{entity_name}}"}],"variable":[]}},"response":[{"id":"e7e9714a-e808-4615-b3e6-dccc2550bdd8","name":"ALL Entity Details Example","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://cosylab.iiitd.edu.in/api/entity/getentities?category={{category_name}}&name={{entity_name}}","host":["https://cosylab.iiitd.edu.in/api"],"path":["entity","getentities"],"query":[{"key":"category","value":"{{category_name}}","description":"String (name or partial name) (Optional)"},{"key":"name","value":"{{entity_name}}","description":"String (name or partial name) (Optional)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Rate-Limit-Remaining","value":"49"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Sun, 22 Nov 2020 20:18:54 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"entity_id\": 2,\n \"category_readable\": \"Bakery\",\n \"entity_alias\": \"bread\",\n \"entity_alias_basket\": \"bread, bread-preferment\",\n \"entity_alias_readable\": \"Bread\",\n \"entity_alias_synonyms\": \"Bread\",\n \"entity_alias_url\": \"https://en.wikipedia.org/wiki/Bread\",\n \"natural_source_name\": \"Poacceae\",\n \"natural_source_url\": \"https://en.wikipedia.org/wiki/Poaceae\"\n }\n]"}],"_postman_id":"81e4e7f5-78cc-41ea-9504-1dfece346b91"},{"name":"Entity Details By ID","id":"ea4009ff-28fc-4849-8d7e-8fb7744d0a7f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://cosylab.iiitd.edu.in/api/entity/getentitybyid/{{entity_id}}","description":"

To fetch the details of an entity by entity id

To fetch the details of all the entities with a given natural source.\nPartial search is also supported, for e.g. if we provide App as the natural_source, it return list of all natural sources where App is present as substring.

To fetch the details of a molecule by molecule id

To fetch the details of the molecule by Molecule Name

To get the autocomplete suggestions for molecules based on the molecule_search_string passed in the request

To search for molecules using the molecule properties. You can also enable advance search by setting advance_search parameter value to true. Advance search allows fine grained control to search the results based on some additional parameters

String (name or partial name) (Optional) used with both common search and advanced search

\n","type":"text/plain"},"key":"commonName","value":"{{comm_name}}"},{"description":{"content":"

String (name or partial name) (Optional) used with both common search and advanced search

\n","type":"text/plain"},"key":"functionalGroup","value":"{{func_grp}}"},{"description":{"content":"

String (name or partial name) (Optional) used with both common search and advanced search

\n","type":"text/plain"},"key":"flavorProfile","value":"{{flv_profile}}"},{"description":{"content":"

String (name or partial name) (Optional) used with both common search and advanced search

\n","type":"text/plain"},"key":"femaFlavorProfile","value":"{{fem_flv_profile}}"},{"description":{"content":"

Integer (Single) (Optional) used with both common search and advanced search.

\n","type":"text/plain"},"key":"molecularWeightFrom","value":"{{mol_weight_from}}"},{"description":{"content":"

Integer (Single) (Optional) used with both common search and advanced search.

\n","type":"text/plain"},"key":"molecularWeightTo","value":"{{mol_weight_to}}"},{"description":{"content":"

Integer (Single) (Optional) used with both common search and advanced search.

\n","type":"text/plain"},"key":"hydrogenBondDonors","value":"{{hbd}}"},{"description":{"content":"

Integer (Single) (Optional) used with both common search and advanced search.

\n","type":"text/plain"},"key":"hydrogenBondAcceptors","value":"{{hba}}"},{"description":{"content":"

String (name): take any one string from ('natural','synthetic','unknown_natural') \n(Optional) used with both common search and advanced search

\n","type":"text/plain"},"key":"typeOfMolecules","value":"{{type_of_mol}}"},{"description":{"content":"

Boolean (Optional)

\n","type":"text/plain"},"key":"advanced_search","value":"true"},{"description":{"content":"