# `smallforce social analytics posts list`

List post analytics with sorting and pagination

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.7. Run `smallforce social analytics posts list --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce social analytics posts list [options]

List post analytics with sorting and pagination

Options:
  --sort <field>         date, engagement, impressions, reach, likes, comments, shares, saves,
                         clicks, or views
  --order <order>        asc or desc
  --limit <n>            Page size from 1 to 250
  --page <n>             Provider page number
  --account <accountId>  Scope to one account id from social accounts list
  --profile <profileId>  Scope to one profile id from social profiles list
  --platform <platform>  Scope to one platform key
  --source <source>      all, smallforce, or external
  --from <YYYY-MM-DD>    Inclusive start date
  --to <YYYY-MM-DD>      Inclusive end date
  --api-key <key>        SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>    SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                 Print stable machine-readable JSON
  --text                 Print human-readable text
  --format <format>      Output format: text or json
  -h, --help             display help for command
```

## Related reference

- [`smallforce social analytics posts`](/docs/cli/commands/social/analytics/posts): 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.