---
title: research it-trend
description: Explore IT-trend categories, products, and business issues, and
  compare supply with document-request ranking coverage.
canonical_url: https://orchestor.io/docs/en/cli/research/it-trend
markdown_url: https://orchestor.io/docs/en/cli/research/it-trend.md
contentType: reference
---

# research it-trend

Explore IT-trend categories, products, and business issues, and compare supply with document-request ranking coverage. Find a category ID before listing its products.

## Usage

```bash title="terminal"
orc research it-trend categories list --workspace YOUR_WORKSPACE_ID --json
```

*Find a category to research*

## Subcommands

### `categories list`

Search IT-trend categories

```bash title="terminal"
orc research it-trend categories list [options]
```

#### Unique options

##### `--q`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend categories list --q <value>
```

##### `--group-id`

value

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend categories list --group-id <value>
```

##### `--issue-id`

value

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend categories list --issue-id <value>
```

##### `--view`

Compact removes repeated catalogs and ID arrays; full includes all catalog membership records and evidence.; enum: compact|full

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend categories list --view <value>
```

### `categories get`

Get IT-trend category product count

```bash title="terminal"
orc research it-trend categories get <id> [options]
```

#### Unique options

##### `--view`

Compact removes repeated catalogs and ID arrays; full includes all catalog membership records and evidence.; enum: compact|full

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend categories get <id> --view <value>
```

### `categories products list`

List IT-trend category products

```bash title="terminal"
orc research it-trend categories products list <id> [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend categories products list <id> --page <value>
```

##### `--view`

Compact removes repeated catalogs and ID arrays; full includes all catalog membership records and evidence.; enum: compact|full

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend categories products list <id> --view <value>
```

### `categories ranking get`

Get IT-trend document-request ranking

```bash title="terminal"
orc research it-trend categories ranking get <id> [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend categories ranking get <id> --page <value>
```

##### `--view`

Compact removes repeated catalogs and ID arrays; full includes all catalog membership records and evidence.; enum: compact|full

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend categories ranking get <id> --view <value>
```

### `directory get`

Get IT-trend taxonomy

```bash title="terminal"
orc research it-trend directory get [options]
```

#### Unique options

##### `--view`

Compact removes repeated catalogs and ID arrays; full includes all catalog membership records and evidence.; enum: compact|full

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend directory get --view <value>
```

### `issues list`

Search IT-trend business issues

```bash title="terminal"
orc research it-trend issues list [options]
```

#### Unique options

##### `--q`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend issues list --q <value>
```

##### `--theme-id`

value

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend issues list --theme-id <value>
```

##### `--view`

Compact removes repeated catalogs and ID arrays; full includes all catalog membership records and evidence.; enum: compact|full

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend issues list --view <value>
```

### `market get`

Compare IT-trend category supply and ranking coverage

```bash title="terminal"
orc research it-trend market get [options]
```

#### Unique options

##### `--q`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend market get --q <value>
```

##### `--group-id`

value

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend market get --group-id <value>
```

##### `--issue-id`

value

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend market get --issue-id <value>
```

##### `--offset`

(use "null" or "reset" to clear)

Type: `number`. Optional.

```bash title="terminal"
orc research it-trend market get --offset <value>
```

##### `--view`

Compact removes repeated catalogs and ID arrays; full includes all catalog membership records and evidence.; enum: compact|full

Type: `string`. Optional.

```bash title="terminal"
orc research it-trend market get --view <value>
```

## Views and rankings

`view=compact` omits repeated catalogs and ID arrays. `view=full` includes membership and evidence. Rankings reflect document requests, not satisfaction.

## Permissions

Sign in with `orc auth login` using a beta-approved account, or use an API key with the `read` scope. Select an accessible workspace with `--workspace`. No research-specific workspace allowlist is required.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc research it-trend`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

[Documentation index](https://orchestor.io/docs/llms.txt)
