{"id":22485055,"url":"https://github.com/sanity-io/GROQ","last_synced_at":"2025-08-02T18:31:21.502Z","repository":{"id":37414981,"uuid":"193940239","full_name":"sanity-io/GROQ","owner":"sanity-io","description":"Specification for GROQ - The Query Language for JSON","archived":false,"fork":false,"pushed_at":"2024-09-25T22:20:58.000Z","size":422,"stargazers_count":399,"open_issues_count":34,"forks_count":15,"subscribers_count":15,"default_branch":"main","last_synced_at":"2024-12-01T03:33:04.578Z","etag":null,"topics":["json","json-data","query-language","sanity-io"],"latest_commit_sha":null,"homepage":"https://groq.dev","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/sanity-io.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":"2019-06-26T16:23:22.000Z","updated_at":"2024-11-12T22:16:35.000Z","dependencies_parsed_at":"2024-04-04T15:27:44.351Z","dependency_job_id":"b2c31e16-2ffc-45af-b7c7-dc912f8e05b0","html_url":"https://github.com/sanity-io/GROQ","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanity-io%2FGROQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanity-io%2FGROQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanity-io%2FGROQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanity-io%2FGROQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sanity-io","download_url":"https://codeload.github.com/sanity-io/GROQ/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228499923,"owners_count":17929985,"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":["json","json-data","query-language","sanity-io"],"created_at":"2024-12-06T17:11:57.964Z","updated_at":"2024-12-06T17:13:40.662Z","avatar_url":"https://github.com/sanity-io.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# GROQ specification\n\n👉🏻 **Published versions of the spec can be viewed [here](https://spec.groq.dev)**.\n\nThis is the specification for GROQ (Graph-Relational Object Queries), a query language and execution engine made at [Sanity.io](https://www.sanity.io), for filtering and projecting JSON documents.\nThe work started in 2015, and the development of this open standard started in 2019.\nRead the [announcement blog post](https://www.sanity.io/blog/we-re-open-sourcing-groq-a-query-language-for-json-documents) to understand more about the specification process and see the [getting started guide](https://www.sanity.io/docs/how-queries-work) to learn more about the language itself.\n\nGo to [GROQ Arcade](https://groq.dev) to try out GROQ with any JSON data today!\n\n## Tools and resources for GROQ\n\n* [Syntax highlighting in VS Code](https://github.com/sanity-io/vscode-sanity).\n* [Syntax highlighting in Sublime Text](https://github.com/alevroub/groq-syntax-highlighting).\n* [GROQ tagged template literal](https://www.npmjs.com/package/groq), for writing GROQ queries in JavaScript files.\n* [groq-cli](https://github.com/sanity-io/groq-cli), a command-line tool for running GROQ on files and URLs.\n* [groq-js](https://github.com/sanity-io/groq-js), a JavaScript implementation of GROQ.\n* [Go GROQ library](https://github.com/sanity-io/go-groq), a Go implementation of the GROQ parser.\n* [groqfmt](https://github.com/sanity-io/groqfmt), a command-line formatter for GROQ, written in Go.\n\n## Development of the specification\n\nThe specification is written using [spec-md](https://spec-md.com), a Markdown variant optimized for writing specifications.\nThe source is located under the `spec/`-directory which is then converted into HTML and presented at \u003chttps://spec.groq.dev\u003e.\nTo ensure that implementations are compatible we write test cases in the [GROQ test suite](https://github.com/sanity-io/groq-test-suite).\n\nThe specification follows the versioning scheme of **GROQ-X.revisionY** where X (major) and Y (revision) are numbers:\n\n- The first version is GROQ-1.revision0.\n- Later revisions are always backwards compatible with earlier revisions in the same major version.\n- Revisions can include everything from minor clarifications to whole new functionality.\n- Major versions are used to introduce breaking changes.\n\n## License\n\nThe specification is made available under the Open Web Foundation Final Specification Agreement (OWFa 1.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanity-io%2FGROQ","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsanity-io%2FGROQ","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanity-io%2FGROQ/lists"}