# `smallforce ads insights`

Run synchronous Meta advertising insights queries

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.8. Run `smallforce ads insights --help` locally to view the same reference for your installed version.

## Subcommands

- [`smallforce ads insights query`](/docs/cli/commands/ads/insights/query): Run a synchronous Meta Insights query

## Complete command help

```text
Usage: smallforce ads insights [options] [command]

Run synchronous Meta advertising insights queries

Options:
  -h, --help                  display help for command

Commands:
  query [options] <targetId>  Run a synchronous Meta Insights query
  help [command]              display help for command
```

## Related reference

- [`smallforce ads`](/docs/cli/commands/ads): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.