{"id":15065887,"url":"https://github.com/isabelle-dev/graphql","last_synced_at":"2026-01-30T19:02:24.213Z","repository":{"id":57537750,"uuid":"256578379","full_name":"Isabelle-Dev/graphql","owner":"Isabelle-Dev","description":"Animal Crossing: New Horizons GraphQL API \u0026 Server","archived":false,"fork":false,"pushed_at":"2020-11-05T04:58:46.000Z","size":8166,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-10T14:14:26.991Z","etag":null,"topics":["animal-crossing","animal-crossing-new-horizons","api","api-server","graphql","graphql-server"],"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/Isabelle-Dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2020-04-17T18:19:07.000Z","updated_at":"2021-06-18T17:36:36.000Z","dependencies_parsed_at":"2022-09-07T17:34:53.681Z","dependency_job_id":null,"html_url":"https://github.com/Isabelle-Dev/graphql","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/Isabelle-Dev%2Fgraphql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Isabelle-Dev%2Fgraphql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Isabelle-Dev%2Fgraphql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Isabelle-Dev%2Fgraphql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Isabelle-Dev","download_url":"https://codeload.github.com/Isabelle-Dev/graphql/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247297665,"owners_count":20915890,"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":["animal-crossing","animal-crossing-new-horizons","api","api-server","graphql","graphql-server"],"created_at":"2024-09-25T00:56:53.141Z","updated_at":"2026-01-30T19:02:24.178Z","avatar_url":"https://github.com/Isabelle-Dev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/1/17/GraphQL_Logo.svg/1024px-GraphQL_Logo.svg.png\" height=\"200\" width=\"200\"\u003e\n  \u003ch1 align=\"center\"\u003e ACNH - GraphQL Server \u003c/h1\u003e\n  \u003cp align=\"center\"\u003eAn open source Animal Crossing New Horizons GraphQL API Server \u0026 Endpoint \u003c/p\u003e\n\u003c/p\u003e\n\nACNH - GraphQL is a Animal Crossing New Horizons [GraphQL](https://graphql.org/) API server. It handles API requests and supports an interactive GraphQL IDE to sample queries.\n\n---\n\n:exclamation: NOTE :exclamation:\n\nThis project is no longer maintained as of 11/04/2020. Please disregard mentions of hosted API server and\ndatabase update status.\n\nAlthough this project is not maintained anymore, feel free to fork from this repo and update it for your needs.\n\n---\n\n**Why GraphQL?**\n\nI chose GraphQL for several reasons!\n\n1. I wanted to learn it!\n2. I'm writing an API for all kinds of developers, and I don't know what data they need - graphql handles data selection very well\n3. GraphQL allows me to let you customize options very well (i.e. check out Docs for Filters!)\n\n**Ready to get started?**\n\nRead the API documentation [here](#documentation)!\n\n- If you're new to GraphQL, I suggest you read all the Doc pages\n- If you've used GraphQL before, you can skip the GraphQL Doc\n\n## Table of Contents\n\n- [Server Database Status](#server-database-status)\n- [Self-Hosting Installation](#self-hosting-installation)\n- [Sample JSON Responses](#sample-json-responses)\n- [Documentation](#documentation)\n- [Example Queries](#example-queries)\n- [cURL](#curl)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Server Database Status\n\n| Icon               |  Status           |\n|:------------------:|:------------------|\n| :heavy_check_mark: | OK                |\n| :x:                | NOT READY         |\n| :warning:          | TO BE UPDATED     |\n\n| Table              | Status                | Summary                          |\n|:-------------------|:---------------------:|:---------------------------------|\n| Item               | :heavy_check_mark:    | Item-related Entries             |\n| Wallpaper          | :heavy_check_mark:    | Wallpaper Entries                |\n| Floor              | :heavy_check_mark:    | Flooring Entries                 |\n| Clothes            | :heavy_check_mark:    | Clothing Entries                 |\n| Music              | :heavy_check_mark:    | KK Slider Music Entries          |\n| Photos             | :heavy_check_mark:    | Villager Photo Entries           |\n| Posters            | :heavy_check_mark:    | Villager Poster Entries          |\n| Rug                | :heavy_check_mark:    | Rug Entries                      |\n| Tools              | :heavy_check_mark:    | Tool Entries                     |\n| Villager           | :heavy_check_mark:    | Villager Entries                 |\n| Bugs               | :heavy_check_mark:    | Bug Entries                      |\n| Fishes             | :heavy_check_mark:    | Fish Entries                     |\n| Fossils            | :heavy_check_mark:    | Fossil Entries                   |\n| Fencing            | :heavy_check_mark:    | Fence Entries                    |\n| Umbrellas          | :heavy_check_mark:    | Umbrellas                        |\n| Art                | :heavy_check_mark:    | Art Entries                      |\n| Construction       | :heavy_check_mark:    | Construction Project Entries     |\n| Nook Miles         | :heavy_check_mark:    | Nook Miles Options               |\n| Reactions          | :heavy_check_mark:    | Reaction Types                   |\n| Other              | :heavy_check_mark:    | Other Misc. Entries              |\n\nCheck [issues](https://github.com/Isabelle-Dev/graphql/issues) for detailed descriptions on **TO BE UPDATED** tables.\n\n## Self-Hosting Installation\n\nWant to host the server yourself?\n\n- Run `go get -u github.com/Isabelle-Dev/graphql` in terminal\n- Setup [PostgreSQL](https://www.postgresql.org/)\n- Create and configure `.config` file using `example.config` as template\n- Import data using `csv` files\n- `go build -o graphql.exe`\n- `./graphql.exe`\n\nAll **csv data files** can be found in the `csv` directory. Postgres migration code (for linux) can be found in `csv/linux`. `csv/master` contains the master excel data sheet used for data importation and cleaning.\n\n## Sample JSON Responses\n\n**Sample JSON** responses can be found in the `newhorizons/sample` directory.\n\nYou can also play around with different query options by visiting [https://acnhgraphql.com](https://acnhgraphql.com/)\n\nThe endpoint itself renders GraphiQL - a GraphQL IDE.\n\n## Documentation\n\n| Doc Type   | Documentation                           |\n|:-----------|:---------------------------------------:|\n| GraphQL    | [:book:](Docs/graphql.md)               |\n| Queries    | [:book:](Docs/query.md)                 |\n| Filters    | [:book:](Docs/filters.md)               |\n| Schema     | [:book:](Docs/schema.md)                |\n\n## Example Queries\n\n:exclamation: **See Documentation For More Info** :exclamation:\n\n```graphql\nquery FloorDemo {\n  floor {\n    query(query: \"buy:\\\"\u003c= 3000 AND \u003e 2000\\\" color:\\\"gray AND beige\\\"\", limit: 3) {\n      floors {\n        Colors\n        Catalog\n        Concepts\n        Sell\n        SourceNotes\n        Tag\n        Image\n        VFX\n        Buy\n        Name\n      }\n    }\n  }\n}\n```\n\n```graphql\nquery ItemDemo {\n  item {\n    query(query: \" name:\\\"leaf\\\" tag:\\\"plant\\\" color:\\\"orange\\\" \", glob:\"t\") {\n      items {\n        Name\n        Buy\n        Sell\n        Concepts\n        HHASet\n        HHASeries\n        Variants {\n          Colors\n          Pattern\n          Image\n          Variation\n        }\n        Tag\n      }\n    }\n  }\n}\n```\n\n```graphql\nquery ArtDemo {\n  art {\n    query(query: \"buy: \\\"4980\\\" tag: \\\"picture\\\" \") {\n      art {\n        Name\n        Buy\n        Tag\n        Category\n        Source\n        Type {\n          Concepts\n          Genuine\n          Sell\n          Image\n        }\n      }\n    }\n  }\n}\n```\n\n## cURL\n\nExample **cURL** queries can be found at [post.json](post.json) and [post.graphql](post.graphql). I do not recommend making graphql requests using pure cURL, but if you must, it's easier to port requests using an external file.\n\n**Example cURL With JSON File:**\n\n`curl -H \"Content-Type:application/json\" --data @post.json https://acnhgraphql.com`\n\n**Example cURL With graphql File:**\n\n`curl -H \"Content-Type:application/graphql\" --data @post.graphql https://acnhgraphql.com`\n\n## Contributing\n\nSee [CONTRIBUTING](.github/CONTRIBUTING.md) for more details.\n\n## License\n\nIsabelle-Dev graphql server is licensed under the **MIT License**.\n\nSee [License](LICENSE) for more details.\n\n## External Contributions\n\n- All data is sourced from New Horizons data found [here](https://docs.google.com/spreadsheets/d/13d_LAJPlxMa_DubPTuirkIV4DERBMXbrWQsmSh8ReK4/)\n\n- High-resolution image links are provided by [Dodo Codes](https://acnhcdn.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisabelle-dev%2Fgraphql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fisabelle-dev%2Fgraphql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisabelle-dev%2Fgraphql/lists"}