{"id":21153294,"url":"https://github.com/sottey/setgo-api","last_synced_at":"2025-03-14T15:12:20.488Z","repository":{"id":226853924,"uuid":"769811062","full_name":"sottey/setgo-api","owner":"sottey","description":"Unauthorized, no affiliation API to serve up Setapp applications and metadata in an API","archived":false,"fork":false,"pushed_at":"2024-03-10T05:58:35.000Z","size":8522,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-06T09:16:53.553Z","etag":null,"topics":["api","golang","setapp"],"latest_commit_sha":null,"homepage":"","language":"Go","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/sottey.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,"publiccode":null,"codemeta":null}},"created_at":"2024-03-10T05:50:03.000Z","updated_at":"2024-11-15T03:33:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"f1c91b15-fdf6-4a2f-b498-a7a0ac9731a6","html_url":"https://github.com/sottey/setgo-api","commit_stats":null,"previous_names":["sottey/setgo-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fsetgo-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fsetgo-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fsetgo-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fsetgo-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sottey","download_url":"https://codeload.github.com/sottey/setgo-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243597842,"owners_count":20316844,"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","golang","setapp"],"created_at":"2024-11-20T10:53:35.084Z","updated_at":"2025-03-14T15:12:20.469Z","avatar_url":"https://github.com/sottey.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n![Logo](https://seanottey.elzs.net/setgo-api.png)\n\nAn unofficial, unauthorized, unknown, unapproved caching API for [SetApp](https://setapp.com) data\n\n## Features\n\n- Programmatic access to SetApp data\n- Complete app data including icons, links, release date and more\n- Caching to minimize impact on SetApp servers\n- Full text search of app names and descriptions\n- Category listing\n- Subcategory id and name listing\n- Apps by category\n## API REFERENCE\n\n#### SHOW HELP\n\n```\n  GET /\n```\n\n| Parameter | Type     | Description                |\n| :-------- | :------- | :------------------------- |\n| `none` | `none` | `none` |\n\n*Returns API information*\n\n\n#### GET ALL APPS\n\n```\n  GET /apps\n```\n\n| Parameter | Type     | Description                       |\n| :-------- | :------- | :-------------------------------- |\n| none     | none | none |\n\n*Returns all apps*\n\n\n#### GET APP INFORMATION BY ID\n```\n  GET /apps/{id}\n```\n| Parameter | Type     | Description                       |\n| :-------- | :------- | :-------------------------------- |\n| `id`     | `string` | `ID of app in collection` |\n\n*Returns app information for app with specified id*\n\n#### GET ALL CATEGORY NAMES\n```\n  GET /cats\n```\n| Parameter | Type     | Description                       |\n| :-------- | :------- | :-------------------------------- |\n| `none`     | `none` | `none` |\n\n*Returns all category names*\n\n#### GET ALL APPS IN CATEGORY\n```\n  GET /cats/{category}\n```\n| Parameter | Type     | Description                       |\n| :-------- | :------- | :-------------------------------- |\n| `category`     | `string` | `Name of category` |\n\n*Returns all apps in specified category*\n\n#### GET SUBCATEGORY IDS AND NAMES\n```\n  GET /subcats\n```\n| Parameter | Type     | Description                       |\n| :-------- | :------- | :-------------------------------- |\n| `none`     | `none` | `none` |\n\n*Returns all subcategories*\n\n#### SEARCH APPS\n```\n  GET /search/{query}\n```\n| Parameter | Type     | Description                       |\n| :-------- | :------- | :-------------------------------- |\n| `query`     | `string` | `Term to search for` |\n\n*Return all items which have the query provided in their name or description*\n\n\n\n## TECH STACK\n\n- [Go](https://go.dev)\n- [SetApp data](https://setapp.com)\n\n\n## DEPLOYMENT\n\nTo deploy this project get the release executable for your OS or clone the source and build \n\n```bash\n  git clone https://www.github.com/sottey/setgo-api\n  sudo go build setgo-api.go\n```\n\n## .ENV FILE\nTo run, edit the **./.env** file and set the following values:\n| Parameter | Type     | Description                       |\n| :-------- | :------- | :-------------------------------- |\n| SETAPP_URL| string | SetApp apps page (probably https://setapp.com/apps) |\n| CACHE_FILE | string | File location of cached json data |\n| SUBCAT_FILE | string | Id and name mapping json |\n| HELP_TEMPLATE | string | File location of HTML template for help (/)|\n| SERVER_URL | string | URL and port to server the data |\n| FAVICON | string | File location of favicon | \n\n## RUNNING THE SERVER\n```bash\n  ./setgo-api\n```\n\nOnce running, you will be able to access the help page at the url specified in the .env file\n\n\n## LICENSE\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n\n## AUTHORS\n\n- [@sottey](https://www.github.com/sottey)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsottey%2Fsetgo-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsottey%2Fsetgo-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsottey%2Fsetgo-api/lists"}