Examples

goro discover -q "reviews for a restaurant on google maps"
goro inspect -s maps.reviews
goro run -s maps.reviews -i '{"startUrls":[{"url":"https://maps.app.goo.gl/xyz"}],"maxReviews":20}' -o reviews.json

goro run -s web.search -i '{"queries":"best espresso machines 2026"}' -j \
  | jq -r '.output[0].organicResults[] | "\(.position)  \(.title)  \(.url)"'

1  Best Espresso Machines for Coffee Nerds & Beginners ...  https://www.bonappetit.com/story/best-espresso-machines
2  Best Espresso Machine 2026?  https://www.reddit.com/r/espresso/comments/...
3  The Best Espresso Machine for Home in 2026 - Cafe Bueno  https://shopcafebueno.com/blogs/...

goro discover -q "linkedin company employees" -j \
  | jq -r '.items[] | "\(.slug)\t\(.price.summary)"'

#!/bin/bash
set -u

goro run -s web.search -i '{"queries":"ai agent frameworks"}' -o out.json
case $? in
  0) jq '.output_count' out.json ;;
  1) echo "bad request, not retrying" ; exit 1 ;;
  2) echo "key rejected, check GORO_API_KEY" ; exit 1 ;;
  3) echo "wallet empty, topping up needed" ; exit 1 ;;
  4) echo "upstream failed, retrying once in 60s"
     sleep 60
     goro run -s web.search -i '{"queries":"ai agent frameworks"}' -o out.json ;;
esac

#!/bin/bash
# Halt the batch when the balance drops under a dollar.
floor=1000000  # micro-USD

while read -r query; do
  available=$(goro balance -j | jq '.available_micro')
  if [ "$available" -lt "$floor" ]; then
    echo "balance $available below floor, stopping"
    break
  fi
  goro run -s web.search -i "$(jq -n --arg q "$query" '{queries:$q}')" \
    -o "results/$(echo "$query" | tr ' /' '__').json"
done < queries.txt

# inputs.jsonl, one JSON object per line
while read -r line; do
  echo "$line" | goro run -s instagram.profile -f - -j >> out.jsonl
done < inputs.jsonl

# Kick it off and come back later.
run_id=$(goro run -s maps.places -f big-query.json -j | jq -r '.run_id')

# ... other work ...

goro runs get -r "$run_id" --wait --timeout 900 -o places.json

goro run -s video.grok \
  -i '{"prompt":"The camera pulls back slowly as the neon sign flickers.","duration":6}' \
  --image ./storefront.jpg --wait -o clip.json

curl -sL "$(jq -r '.output[0]' clip.json)" -o clip.mp4

GORO_CONFIG_HOME=~/.goro-client-a goro setup
GORO_CONFIG_HOME=~/.goro-client-b goro setup

alias goro-a='GORO_CONFIG_HOME=~/.goro-client-a goro'
alias goro-b='GORO_CONFIG_HOME=~/.goro-client-b goro'

goro-a balance
goro-b balance

goro keys use client-a

- name: Fetch competitor prices
  env:
    GORO_API_KEY: ${{ secrets.GORO_API_KEY }}
  run: |
    npx goro run -s amazon.search \
      -i '{"searchTerms":["espresso machine"],"maxItems":20}' \
      -o prices.json

goro discover -q "web search" --api http://localhost:3030

goro runs list -n 5 -j | jq -r '.items[] | "\(.endpoint)\t\(.cost_usd)\t\(.output_count) rows"'

web.search	$0.0105	1 rows
web.search	$0.0105	1 rows
maps.places	$0.1420	20 rows