For humans

You do not need an agent to use Goro. A key and curl are enough to try the catalog, and the dashboard shows what every call cost. Go to app.usegoro.ai and sign in with Google or with an emailed code. A workspace and a wallet are created for you.

2. Pick a plan

Running anything, even your first call, needs an active plan. Open Billing and subscribe to Build (

19 a month,

25 of included credit) or Scale (

99 a month,

150 of included credit). Signing up and browsing the catalog are free; running a tool is not.

3. Create a key

Open API keys and create one. You see the full key exactly once, at creation, so copy it then. Goro stores only a hash of it, which means we cannot show it to you again and a database leak cannot leak a usable key.

export GORO_API_KEY="goro_live_..."

Check it works:

curl https://api.usegoro.ai/v1/whoami \
  -H "Authorization: Bearer $GORO_API_KEY"

4. Find a tool

You do not need to know the catalog. Describe what you want.

curl -X POST https://api.usegoro.ai/v1/discover \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "coffee shops in bucharest"}'

Each result carries a slug, guidance on when to use it, and a price. You can also browse the same catalog under Tools in the dashboard, or in the tool reference here.

5. See what it takes

curl -X POST https://api.usegoro.ai/v1/inspect \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug": "maps.places"}'

inspect returns the tool’s real input schema and a sample_input you can send almost as-is.

6. Run it

curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "maps.places",
    "input": {
      "searchStringsArray": ["specialty coffee"],
      "locationQuery": "Bucharest, Romania",
      "maxCrawledPlacesPerSearch": 5
    }
  }'

A fast call returns 200 with the rows in output and cost_usd telling you what it cost. A slower one returns 202 with a run_id, and you poll:

curl https://api.usegoro.ai/v1/runs/$RUN_ID \
  -H "Authorization: Bearer $GORO_API_KEY"

Goro does not store results. The rows arrive in the response that finishes the run and are never written to our database, so pipe the output to a file if you want to keep it.

7. Watch the money

curl https://api.usegoro.ai/v1/wallet/balance \
  -H "Authorization: Bearer $GORO_API_KEY"

The dashboard covers the same ground with more context:

Page	What it is for
Wallet	Your plan, one-time top-ups (minimum $5), the full ledger, and the Stripe portal for your card
Usage	What you have spent over time, run by run
Budgets	A daily or monthly cap, set to block calls or just notify you
API keys	Create and revoke keys. Revoking takes effect immediately

A plan renews on its date, a top-up happens when you make one, and nothing else charges your card. Nothing is ever charged while you are not on the page.

Full API reference

Every endpoint, field and error code.

How pricing works

Rates, totals and ceilings.

Guide

CLI reference

API reference

Tools

2. Pick a plan

3. Create a key

4. Find a tool

5. See what it takes

6. Run it

7. Watch the money

Full API reference

How pricing works

​1. Sign in

​2. Pick a plan

​3. Create a key

​4. Find a tool

​5. See what it takes

​6. Run it

​7. Watch the money

Full API reference

How pricing works

1. Sign in

2. Pick a plan

3. Create a key

4. Find a tool

5. See what it takes

6. Run it

7. Watch the money