Inspect

POST https://api.usegoro.ai/v1/inspect

Everything you need to call a tool correctly on the first try. Call this when you know the slug but not the exact input shape.

Request

Field	Type	Required	Notes
`slug`	string	yes	The tool identifier, for example `maps.places`

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

Response

{
  "slug": "maps.places",
  "name": "Google Maps places",
  "category": "maps",
  "description": "Search Google Maps for places matching a query and get back name, address, rating, review count, phone, website, and coordinates.",
  "when_to_use": "Use when you need local businesses or points of interest, lead lists for a city or area, or place details like ratings and contact info.",
  "input_schema": {
    "type": "object",
    "required": ["searchStringsArray"],
    "properties": {
      "language": { "type": "string", "default": "en" },
      "locationQuery": { "type": "string" },
      "searchStringsArray": { "type": "array", "items": { "type": "string" } },
      "maxCrawledPlacesPerSearch": { "type": "integer", "default": 20 }
    }
  },
  "sample_input": {
    "language": "en",
    "searchStringsArray": "<searchStringsArray>",
    "maxCrawledPlacesPerSearch": 20
  },
  "output_sample": {
    "name": "Origo Coffee",
    "phone": "+40 21 000 0000",
    "rating": 4.6,
    "address": "Strada Lipscani 9, Bucharest",
    "website": "https://origocoffee.ro"
  },
  "price": {
    "type": "cost_plus",
    "markup": 3,
    "min_micro": 2000,
    "min_usd": "$0.0020",
    "max_micro": 6000000,
    "max_usd": "$6.00",
    "billed_on_actual_usage": true,
    "per_unit_micro": 9000,
    "per_unit_usd": "$0.0090",
    "unit_label": "place",
    "summary": "$0.0090 per place, billed on actual usage (3x provider cost, minimum $0.0020), up to $6.00 per call"
  }
}

Field	Type	Notes
`slug`	string	The identifier you passed
`name`	string	Human name
`category`	string	Catalog category
`description`	string	What the tool does
`when_to_use`	string	When this tool is the right choice
`input_schema`	object	JSON Schema draft 7. The real schema, validated on every run
`sample_input`	object	Required fields plus optional fields that have defaults
`output_sample`	object	One illustrative row of what the tool returns
`price`	object	Same shape as in `discover`

On the passthrough tools, which is most of the catalog, Goro hands your input to the underlying tool unchanged and hands back its rows untouched. input_schema is that tool’s own schema, not a translation, so any field the tool accepts works even when the schema does not name it: undeclared fields pass through rather than being rejected.The image and voice tools are wrapped rather than passed through. Their schemas set additionalProperties: false, and a field the schema does not name comes back as a validation_error. Read the flag rather than assuming either behaviour.

inspect deliberately does not expose provider internals. There is no field naming which upstream service or actor runs the job.

Errors

Status	`code`	When
400	`validation_error`	`slug` missing or empty
401	`unauthorized`	Missing or invalid API key
404	`not_found`	Unknown slug, or a tool that is not active. Message reads `unknown endpoint: {slug}`

Inspection is free. It places no hold and charges nothing.

Now run it

Send the input, get the rows.

Guide

CLI reference

API reference

Tools

Request

Response

Errors

Now run it

​Request

​Response

​Errors

Now run it

Request

Response

Errors