{"id":19539700,"url":"https://github.com/illusionman1212/say-cheese","last_synced_at":"2025-04-26T16:31:43.757Z","repository":{"id":47013444,"uuid":"308129862","full_name":"IllusionMan1212/say-cheese","owner":"IllusionMan1212","description":"A cheesy api for all your cheesy needs","archived":true,"fork":false,"pushed_at":"2024-06-10T22:49:38.000Z","size":163,"stargazers_count":3,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-14T12:34:39.565Z","etag":null,"topics":["api","cheese","nodejs","nodejs-api"],"latest_commit_sha":null,"homepage":"https://api.illusionman1212.tech/cheese","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IllusionMan1212.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-28T20:12:27.000Z","updated_at":"2024-12-13T16:20:14.000Z","dependencies_parsed_at":"2022-08-31T13:42:14.956Z","dependency_job_id":null,"html_url":"https://github.com/IllusionMan1212/say-cheese","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IllusionMan1212%2Fsay-cheese","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IllusionMan1212%2Fsay-cheese/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IllusionMan1212%2Fsay-cheese/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IllusionMan1212%2Fsay-cheese/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IllusionMan1212","download_url":"https://codeload.github.com/IllusionMan1212/say-cheese/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251017530,"owners_count":21523601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","cheese","nodejs","nodejs-api"],"created_at":"2024-11-11T02:42:56.127Z","updated_at":"2025-04-26T16:31:42.864Z","avatar_url":"https://github.com/IllusionMan1212.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Say Cheese\nA RESTful api with over 1800 cheeses.\n\n## Limitations\nThe api is limited to 60 requests per minute to prevent abuse and because my server can't handle it lol.\n\n## Routes\n---\n| Route | Parameter | Description |\n| --- | --- | --- |\n| `/random` | None | Returns a random cheese from the db |\n| `/search` | `q`, `page`, `per_page` | Search for cheeses by name |\n| `/today` | None | Returns cheese of the day |\n| `/alphabetical` | `letter`, `page`, `per_page` | Find cheeses by their first letter |\n| `/vegetarian` | `page`, `per_page` | Returns an array of all vegetarian cheeses |\n\n#### Parameters\n---\n```\nq        =\u003e The search query you want to perform. (required)\nletter   =\u003e The letter you want to display the cheeses for. (required)\npage     =\u003e Pagination number. (default = 1)\nper_page =\u003e Number of cheeses to display in a single page. (max = 50; default = 10)\n```\n\n## Example successful response\n---\n```json\n{\n    \"failed\": false,\n    \"status\": \"200\",\n    \"cheese\": {\n        \"country_codes\": [\"IT\"],\n        \"milks\": [\"sheep\"],\n        \"name\": \"Pecorino dei Malatesta al Sangiovese\",\n        \"link\": \"https://cheese.com/pecorino-dei-malatesta-al-sangiovese/\",\n        \"image\": \"https://cheese.com/media/img/icon-cheese-default.svg\",\n        \"description\": \"Produced by Romaniae Terrae, Pecorino dei Malatesta al Sangiovese is an Italian cheese made with highly selected sheep's milk pasteurized at optimum temperature. Cheese wheels are first matured in a cold room at 6° - 8°C. Later, during the final stage of maturation they are treated with Sangiovese red wine and kept in a cold room at 8°C for about 30 days.The Sangiovese red wine gives the cheese a dark burgundy rind beneath which lies a smooth white paste with a delicate mouthfeel and a sweet sheep's milk flavour with an aftertaste of wine.\",\n        \"attributes\": {\n            \"made\": \"Made from pasteurized sheep's milk\",\n            \"countries\": [\"Italy\"],\n            \"region\": \"Emilia-Romagna\",\n            \"family\": \"Pecorino\",\n            \"types\": [\"semi-soft\",\"artisan\"],\n            \"fat\": null,\n            \"calcium\": null,\n            \"textures\": [\"smooth\"],\n            \"rind\": \"natural\",\n            \"color\": \"white\",\n            \"flavors\": [\"acidic\",\"smooth\",\"subtle\",\"sweet\"],\n            \"aromas\": [\"pleasant\"],\n            \"vegetarian\": null,\n            \"producers\": [\"Romaniae Terrae\"],\n            \"synonyms\": [],\n            \"alternative_spellings\": []\n            },\n        \"id\": 1273\n    }\n}\n```\n\n## Example Error response\n---\n```json\n{\n    \"failed\": true,\n    \"status\": \"400\",\n    \"error\": \"Error message\"\n}\n```\n\n| Property | Description |\n| --- | --- |\n| `failed` | Whether the request failed or not (boolean) |\n| `status` | HTTP status code |\n| `cheese` | Cheese object |\n| `id` | Unique cheese id |\n\n#### status values\n---\n200 `OK`: The request was successful and that is returned. \\\n304 `Not Modified`: You already have the latest data. \\\n400 `Bad Request`: You submitted an invalid or incomplete request. \\\n404 `Not Found`: The requested data does not exist. \\\n500 `Internal Server Error`: Something went wrong on our end, please open an issue on the [github](https://github.com/illusionman1212/say-cheese/issues) if this persists.\n\n#### country_codes values\n---\n`AF`= Afghanistan, \\\n`AL`= Albania, \\\n`AD`= Andorra, \\\n`AR`= Argentina, \\\n`AM`= Armenia, \\\n`AU`= Australia, \\\n`AT`= Austria, \\\n`AZ`= Azerbaijan, \\\n`BD`= Bangladesh, \\\n`BY`= Belarus, \\\n`BE`= Belgium, \\\n`BR`= Brazil, \\\n`BG`= Bulgaria, \\\n`CA`= Canada, \\\n`CL`= Chile, \\\n`CN`= China, \\\n`countries-throughout-world`= Other Countries, \\\n`HR`= Croatia, \\\n`CY`= Cyprus, \\\n`CZ`= Czech Republic, \\\n`DK`= Denmark, \\\n`eastern-mediterranean`= Eastern Mediterranean, \\\n`EG`= Egypt, \\\n`england`= England, \\\n`FI`= Finland, \\\n`FR`= France, \\\n`GE`= Georgia, \\\n`DE`= Germany, \\\n`great-britain`= Great Britain, \\\n`GR`= Greece, \\\n`holland`: Holland, \\\n`HU`= Hungary, \\\n`IS`= Iceland, \\\n`IN`= India, \\\n`IR`= Iran, \\\n`IQ`= Iraq, \\\n`IE`= Ireland, \\\n`IM`= Isle of man, \\\n`IL`= Israel, \\\n`IT`= Italy, \\\n`JP`= Japan, \\\n`JO`= Jordan, \\\n`LB`= Lebanon, \\\n`LT`= Lithuania, \\\n`MK`= Macedonia, \\\n`MR`= Mauritania, \\\n`MX`= Mexico, \\\n`mexico-and-caribbean`= Mexico and Caribbean, \\\n`middle-east`= Middle East\", \\\n`MN`= Mongolia, \\\n`NP`= Nepal, \\\n`NL`= Netherlands, \\\n`NZ`= New zealand, \\\n`NO`= Norway, \\\n`PK`= Pakistan, \\\n`PS`= Palestine, \\\n`PL`= Poland, \\\n`PT`= Portugal, \\\n`RO`= Romania, \\\n`RU`= Russia, \\\n`scotland`= Scotland, \\\n`RS`= Serbia, \\\n`SK`= Slovakia, \\\n`ES`= Spain, \\\n`SZ`= Swaziland, \\\n`SE`= Sweden, \\\n`CH`= Switzerland, \\\n`SY`= Syria, \\\n`tibet`= Tibet, \\\n`TR`= Turkey, \\\n`UA`= Ukraine, \\\n`GB`= United Kingdom, \\\n`US`= United States, \\\n`wales`= Wales,\n\n#### milks values\n---\n`buffalo`\n`camel`\n`cow`\n`donkey`\n`goat`\n`mare`\n`moose`\n`reindeer`\n`sheep`\n`water-buffalo`\n`yak`\n\n#### types values\n---\n`artisan`\n`blue-veined`\n`fresh-soft`\n`fresh-firm`\n`soft`\n`semi-soft`\n`semi-hard`\n`hard`\n`semi-firm`\n`firm`\n\n#### textures values\n---\n`brittle`\n`buttery`\n`chalky`\n`chewy`\n`close`\n`compact`\n`creamy`\n`crumbly`\n`crystalline`\n`dense`\n`dry`\n`elastic`\n`firm`\n`flaky`\n`fluffy`\n`grainy`\n`oily`\n`open`\n`runny`\n`semi-firm`\n`smooth`\n`soft`\n`soft-ripened`\n`spreadable`\n`springy`\n`sticky`\n`stringy`\n`supple`\n\n#### color values\n---\n`blue`\n`blue-grey`\n`brown`\n`brownish-yellow`\n`cream`\n`golden-orange`\n`golden-yellow`\n`green`\n`ivory`\n`orange`\n`pale-white`\n`pale-yellow`\n`pink-and-white`\n`red`\n`straw`\n`white`\n`yellow`\n\n\n## Notes about the returned data\n---\n- Any property that does not exist or has an undetermined value will default to `null`.\n- Any array property that does not exist or has an undetermined value will be an empty array `[]`.\n\n##### More routes are coming soon. If you have a route suggestion/request, please feel free to open an issue on the [github](https://github.com/illusionman1212/say-cheese/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fillusionman1212%2Fsay-cheese","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fillusionman1212%2Fsay-cheese","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fillusionman1212%2Fsay-cheese/lists"}