> ## Documentation Index
> Fetch the complete documentation index at: https://vetta.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# vetta social-data

> Search the public social data catalogue, read a tool's input schema, and run it from the terminal.

The three [social data routes](/docs/api/social-data) from the terminal. Search and describe are free; a run is priced at the tool's listed price. It is [`vetta data`](/docs/cli/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`.

```bash theme={"system"}
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.