# CLI Platform Commands

Inspect connected accounts and discover platform-specific ids (Instagram locations,
licensed audio, Pinterest boards) that other commands take as input.

## Accounts

| Command | Description |
|---------|-------------|
| `accounts:list` | List connected accounts with channel ids, platforms, supported content types, and Pinterest boards |
| `accounts:get <id>` | Full details for one account, including platform-specific data such as Pinterest board ids |

```bash
omnisocials accounts:list
```

The channel ids in the output are what `posts:create --channels` expects.

## Location search

| Command | Description |
|---------|-------------|
| `locations:search "<name>"` | Search taggable locations (minimum 2 characters, `--q` or positional). Flags: `--platform <instagram\|threads>` (default `instagram`), and for Threads `--latitude` + `--longitude` instead of a name |

With the default `--platform instagram` it searches Facebook Places and returns
`location_id` values for `posts:create --location-id` (Instagram place tags).
Only places with a street address can be tagged.

```bash
omnisocials locations:search "Amsterdam Central"
omnisocials posts:create \
  --text "Live from Amsterdam" \
  --channels instagram \
  --media-urls https://example.com/photo.jpg \
  --location-id 106039436102339
```

With `--platform threads` it searches Threads locations and returns ids for
`posts:create --threads-location-id`. The two id namespaces are different: a
Facebook Place ID is not a Threads location id, so never reuse one as the
other. Threads also accepts coordinates instead of a name. Threads location
tagging is currently rolling out; until Meta approves the permission the
search answers `not_available`, and Threads connections made before the
permission existed answer `threads_reauth_required` until reconnected.

```bash
omnisocials locations:search "Griffith Observatory" --platform threads
omnisocials locations:search --platform threads --latitude 34.1184 --longitude -118.3004
omnisocials posts:create \
  --text "Best view in the city" \
  --channels threads \
  --threads-location-id 17841400000000000
```

## Audio search

| Command | Description |
|---------|-------------|
| `audio:search ["<song/artist>"]` | Search Meta's licensed music catalog for Instagram Reels. Empty query returns trending audio. Flags: `--type <music\|original_sound>` |

Returns `audio_id` values for `posts:create --instagram-audio-id` (reels only).

```bash
# Trending right now
omnisocials audio:search

# Find a specific track
omnisocials audio:search "daft punk" --type music
```