@faceliftbbt/fds-cli

fds — command-line client for the quintly social media analytics API. Read-only surface: query data and list resources.

Install

npm install -g @faceliftbbt/fds-cli

This puts fds on your PATH. Requires Node.js ≥ 18.

Authenticate

Credentials live at ~/.fds/config.json (mode 0600). They can also be supplied via FDS_CLIENT_ID / FDS_API_SECRET / FDS_BASE_URL env vars or per-invocation flags.

fds login                                    # interactive prompts
fds login --client-id 1234 --api-secret xxx  # non-interactive
fds whoami                                   # show resolved config (secret masked)
fds logout                                   # delete saved file

Examples

# QQL queries
fds qql --profile-ids 12345 \
  --start-time "2026-04-01" --end-time "2026-04-30" \
  --metric followers --interval daily

fds qql --profile-ids 12345 \
  --start-time "2026-04-01" --end-time "2026-04-30" --interval monthly \
  --qql-query "SELECT time, fans FROM facebook"

# Discovery
fds users
fds spaces
fds data-sources
fds use-cases list

# Profiles & ad accounts (read-only)
fds profiles list --space-id 42
fds profiles search "nike" --network instagram
fds profiles list-pending-auths --space-id 42
fds ad-accounts list --space-id 42

# Dashboard share links + data push
fds shares list
fds data-push tasks
fds data-push logs <taskId>

# JSON output for piping
fds --output json profiles list --space-id 42 | jq '.data[].name'

Available commands

fds qql                           # run a QQL query
fds data-sources                  # list supported data sources
fds users / spaces                # list users / spaces on the client
fds profiles {list,search,list-pending-auths}
fds ad-accounts {list,list-pending-auths}
fds use-cases list
fds shares list
fds data-push {tasks,logs}

License

MIT