{"id":13311708,"url":"https://github.com/jonasgeiler/Iconmonstr-API","last_synced_at":"2025-03-10T17:30:42.643Z","repository":{"id":90575820,"uuid":"174016100","full_name":"jonasgeiler/Iconmonstr-API","owner":"jonasgeiler","description":"An unofficial API to access icons from iconmonstr.com","archived":false,"fork":false,"pushed_at":"2019-08-28T14:38:34.000Z","size":64,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-07T16:54:28.200Z","etag":null,"topics":["api","collection","collections","crawler","eps","font","icon","icon-font","iconmonstr","iconmonstr-api","icons","image","images","png","psd","scraper","svg","unofficial","vector","vector-graphics"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/jonasgeiler.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-03-05T20:29:39.000Z","updated_at":"2024-05-31T08:04:26.000Z","dependencies_parsed_at":"2023-03-04T19:15:36.441Z","dependency_job_id":null,"html_url":"https://github.com/jonasgeiler/Iconmonstr-API","commit_stats":null,"previous_names":["jonasgeiler/iconmonstr-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2FIconmonstr-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2FIconmonstr-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2FIconmonstr-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasgeiler%2FIconmonstr-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonasgeiler","download_url":"https://codeload.github.com/jonasgeiler/Iconmonstr-API/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242892572,"owners_count":20202558,"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","collection","collections","crawler","eps","font","icon","icon-font","iconmonstr","iconmonstr-api","icons","image","images","png","psd","scraper","svg","unofficial","vector","vector-graphics"],"created_at":"2024-07-29T18:02:18.702Z","updated_at":"2025-03-10T17:30:42.626Z","avatar_url":"https://github.com/jonasgeiler.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# iconmonstr API\n\nThis is an unofficial API for iconmonstr.com!  \nFetch icons, collections and other directly from their website.  \nThis page crawls all data from iconmonstr.com, no database is used.  \nThat's why the requests can take some time occasionally.\n\nThe API was made in PHP 7 with the limonade.php framework.\n\n## Installation\n\nIf you don't want to use my free-hosted API, you can install it by yourself.  \nAll you need is PHP 7! (other versions not tested - might work)  \nThere's no configuration or anything needed. Just upload the whole repo onto your server!\n\n## Todo\n\n- [ ] Better error messages\n- [ ] Search for collections\n- [ ] png support for icons (costumizing and coloring images and getting their download link)\n\n## API\n\nPlease note that the api is not fully RESTful!\n\n- Icons\n    - [GET /icons/search/](#get-iconssearch)\n    - [GET /icons/popular/](#get-iconspopular)\n    - [GET /icons/new/](#get-iconsnew)\n    - [GET /icons/:slug/](#get-iconsslug)\n- Categories\n    - [GET /categories/](#get-categories)\n    - [GET /categories/:slug/](#get-categoryslug)\n- Collections\n    - [GET /collections/](#get-collections)\n    - [GET /collections/:slug/](#get-collectionsslug)\n- Icon Requests\n    - [GET /icon-requests/](#get-icon-requests)\n    - [GET /icon-requests/:slug/](#get-icon-requestsslug)\n\n\u003cbr\u003e\u003cbr\u003e\n### GET /icons/search/\n\n\u003e Get icons by search query\n\n#### Resource URL\n\n`https://iconmonstr-api.2ix.at/icons/search/`\n\n#### Parameters\n\nParameter                  | Description\n---------                  | -----------\n**query**\u003cbr\u003e*required* | Search query.\u003cbr\u003e**Example Values**: `Arrow`\n**filter**\u003cbr\u003e*optional* | Icon Filter (`all`, `fill`, `bold` or `thin` - defaults to `all`).\u003cbr\u003e**Example Value**: `fill`\n**page**\u003cbr\u003e*optional* | The page to retrieve (defaults to `1`).\u003cbr\u003e**Example Value**: `2`\n\n#### Example Request\n\n##### Request URL:\n\nGET `https://iconmonstr-api.2ix.at/icons/search?query=Arrow\u0026filter=fill`\n\n##### Response:\n\n```javascript\n{\n\t\"success\": true, // False if an error occurred (to be done)\n\t\"pages\": 2, // Amount of pages\n\t\"icons\": [\n\t\t{\n\t\t\t\"slug\": \"cursor-11-svg\", // The slug of the icon (useful for urls)\n\t\t\t\"previewImage\": \"https://cdns.iconmonstr.com/wp-content/assets/preview/2013/96/iconmonstr-cursor-11.png\", // Preview image of the icon\n\t\t\t\"name\": \"Arrow 80\", // Name of the icon\n\t\t\t\"likes\": 2812 // Amount of likes\n\t\t},\n\t\t...\n\t]\n}\n```\n\u003cbr\u003e\u003cbr\u003e\n### GET /icons/popular/\n\n\u003e Get popular icons\n\n#### Resource URL\n\n`https://iconmonstr-api.2ix.at/icons/popular/`\n\n#### Parameters\n\nParameter                  | Description\n---------                  | -----------\n**page**\u003cbr\u003e*optional* | The page to retrieve (defaults to `1`).\u003cbr\u003e**Example Value**: `12`\n\n#### Example Request\n\n##### Request URL:\n\nGET `https://iconmonstr-api.2ix.at/icons/popular?page=12`\n\n##### Response:\n\n```javascript\n{\n\t\"success\": true, // False if an error occurred (to be done)\n\t\"pages\": 75, // Amount of pages\n\t\"icons\": [\n\t\t{\n\t\t\t\"slug\": \"lock-21-svg\", // The slug of the icon (useful for urls)\n\t\t\t\"previewImage\": \"https://cdns.iconmonstr.com/wp-content/assets/preview/2012/96/iconmonstr-lock-21.png\", // Preview image of the icon\n\t\t\t\"name\": \"Lock 21\", // Name of the icon\n\t\t\t\"likes\": 7887 // Amount of likes\n\t\t},\n\t\t...\n\t]\n}\n```\n\u003cbr\u003e\u003cbr\u003e\n### GET /icons/new/\n\n\u003e Get new icons\n\n#### Resource URL\n\n`https://iconmonstr-api.2ix.at/icons/new/`\n\n#### Parameters\n\nParameter                  | Description\n---------                  | -----------\n**page**\u003cbr\u003e*optional* | The page to retrieve (defaults to `1`).\u003cbr\u003e**Example Value**: `3`\n**filter**\u003cbr\u003e*optional* | Icon Filter (`all`, `fill-bold` or `thin` - defaults to `all`).\u003cbr\u003e**Example Value**: `thin`\n\n\u003e Note that other than at the `/icons/search` endpoint, there's only a `fill-bold` (no `fill` or `bold` by it's own)\n\n#### Example Request\n\n##### Request URL:\n\nGET `https://iconmonstr-api.2ix.at/icons/new?page=3\u0026filter=thin`\n\n##### Response:\n\n```javascript\n{\n\t\"success\": true, // False if an error occurred (to be done)\n\t\"pages\": 4, // Amount of pages\n\t\"icons\": [\n\t\t{\n\t\t\t\"slug\": \"video-thin-svg\", // The slug of the icon (useful for urls)\n\t\t\t\"previewImage\": \"https://cdns.iconmonstr.com/wp-content/assets/preview/2018/96/iconmonstr-video-thin.png\", // Preview image of the icon\n\t\t\t\"name\": \"Video\", // Name of the icon\n\t\t\t\"dateInfo\": {\n\t\t\t\t\"raw\": \"9 months ago\", // The raw date string\n\t\t\t\t\"count\": \"9\", // The count of the time unit\n\t\t\t\t\"unit\": \"month\", // The time unit (second/minute/day/week/month/year)\n\t\t\t\t\"plural\": true // Whether the unit is in plural or not (month/months)\n\t\t\t}\n\t\t},\n\t\t...\n\t]\n}\n```\n\u003cbr\u003e\u003cbr\u003e\n### GET /icons/:slug/\n\n\u003e Get a specific icon\n\n#### Resource URL\n\n`https://iconmonstr-api.2ix.at/icons/:slug/`\n\n#### Parameters\n\nParameter                  | Description\n---------                  | -----------\n**slug**\u003cbr\u003e*required* | The URL-friendly name of the icon.\u003cbr\u003e**Example Value**: `github-1`\n**fileType**\u003cbr\u003e*optional* | The file type of the icon (`svg`, `eps`, `psd` or, if available, `font` - defaults to `svg`).\u003cbr\u003e**Example Value**: `svg`\n\n#### Example Request\n\n##### Request URL:\n\nGET `https://iconmonstr-api.2ix.at/icons/github-1?fileType=svg`\n\n##### Response:\n\n```javascript\n{\n\t\"success\": true, // False if an error occurred (to be done)\n\t\"icon\": {\n\t\t\"slug\": \"github-1\", // The slug of the icon (useful for urls)\n\t\t\"url\": \"https://iconmonstr.com/github-1-svg\", // URL of the icon\n\t\t\"availableFileTypes\": [ // Available file types for the fileType parameter\n\t\t\t\"svg\",\n\t\t\t\"eps\",\n\t\t\t\"psd\",\n\t\t\t\"png\", // NOT YET IMPLEMENTED!!!\n\t\t\t\"font\"\n\t\t],\n\t\t\"name\": \"Github 1\", // Name of the icon\n\t\t\"previewImage\": \"https://cdns.iconmonstr.com/wp-content/assets/preview/2012/240/iconmonstr-github-1.png\", // Preview image of the icon\n\t\t\"downloadLink\": \"https://iconmonstr.com/?s2member_file_download_key=b4c27b8119dec7660f7f2adb48227cdc\u0026s2member_file_download=2012/svg/iconmonstr-github-1.svg\", // URL to download the icon\n\t\t\"embedCode\": \"\u003csvg xmlns=\\\"http://www.w3.org/2000/svg\\\" width=\\\"24\\\" height=\\\"24\\\" viewBox=\\\"0 0 24 24\\\"\u003e\u003cpath d=\\\"M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z\\\"/\u003e\u003c/svg\u003e\", // Embed code of the icon (only for svg file type)\n\t\t\"similar\": [ // Similar icons\n\t\t\t\"github-4\",\n\t\t\t\"github-2\",\n\t\t\t\"github-3\",\n\t\t\t\"github-5\"\n\t\t],\n\t\t\"tags\": [ // Icon tags (useful for search)\n\t\t\t\"brand\",\n\t\t\t\"github\",\n\t\t\t\"logo\",\n\t\t\t\"multiservice\",\n\t\t\t\"social\"\n\t\t],\n\t\t\"collection\": \"github\" // The collection the icon is in\n\t}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasgeiler%2FIconmonstr-API","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonasgeiler%2FIconmonstr-API","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasgeiler%2FIconmonstr-API/lists"}