vetta social-data - Naive

The three social data routes from the terminal. Search and describe are free; a run is priced at the tool’s listed price. It is vetta data’s social domain.

Commands

Command	Description
`vetta social-data search "<query>"`	Find tools. `--platform <network>`, `--limit <1-20>`.
`vetta social-data describe <tool_id>`	A tool’s input schema, price and notes.
`vetta social-data run <tool_id>`	Run it; prints the run with its `data` and `cost_micro_usd`.

run

Parameters go where the tool’s describe output says:

Flag	Goes to	Example
`--query key=value`	`query` (repeatable)	`--query username=nasa`
`--path key=value`	`path` (repeatable)	`--path id=1234`
`--body '<json object>'`	`body`	`--body '{"searchTerms":["ai"],"maxItems":5}'`

key=value is always text — a username of digits stays a string. Use key:=value for a JSON value: --query count:=5, --query verified:=true.

vetta social-data search "instagram profile" --platform instagram
vetta social-data describe <tool_id>
vetta social-data run <tool_id> --query username=nasa

A failed run exits 0 and prints status: "failed" with its error and cost_micro_usd: 0. A refusal before the run (empty balance, unknown tool) exits non-zero with the error envelope.