Skip to main content

Overview

The Geo API is a read-only GraphQL endpoint for the Geo knowledge graph.

You make HTTP POST requests with a GraphQL query body, and you get back JSON with the entities, types, properties, and relations that match.

There are no mutations on this API. Writing data to the graph happens through a different path — you build operations using the Geo SDK and submit them as edits to a smart contract on chain. After the edit is indexed, the new data shows up in this read API.

Endpoint​

https://testnet-api.geobrowser.io/graphql

Geo currently runs on testnet. There's no separate mainnet endpoint yet — when one ships, the URL will appear here.

Auth​

The read API is fully public. No API key, no auth token, no rate limits announced (be polite anyway).

What lives in the graph?​

A few core concepts you'll see everywhere — covered in detail in Concepts:

  • Space — a governance container. Personal or DAO. Holds entities.
  • Entity — a node. Has values (typed properties) and relations (typed edges to other entities).
  • Type — a tag applied to entities via a relation. An entity can have multiple types.
  • Property — a typed field definition (e.g. "Name", "Description", "Web URL").
  • Relation — a directed edge between two entities, itself an entity with its own ID.

Next up: Quickstart — make your first request.