---
title: research aspic
description: Search ASPIC services, articles, categories, and authors.
canonical_url: https://orchestor.io/docs/en/cli/research/aspic
markdown_url: https://orchestor.io/docs/en/cli/research/aspic.md
contentType: reference
---

# research aspic

Search ASPIC services, articles, categories, and authors. Start with identity details, then request only the content sections you need.

## Usage

```bash title="terminal"
orc research aspic search --q CRM --type service --workspace YOUR_WORKSPACE_ID --json
```

*Search for a service*

## Subcommands

### `articles list`

List articles

```bash title="terminal"
orc research aspic articles list [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic articles list --page <value>
```

##### `--per-page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic articles list --per-page <value>
```

##### `--q`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic articles list --q <value>
```

##### `--slug`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic articles list --slug <value>
```

##### `--category`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic articles list --category <value>
```

### `articles get`

Get ASPIC article

```bash title="terminal"
orc research aspic articles get <id> [options]
```

#### Unique options

##### `--body`

Explicitly request parsed content; identity only by default.; enum: true|false

Type: `string`. Optional.

```bash title="terminal"
orc research aspic articles get <id> --body <value>
```

##### `--section`

Return matching headings instead of the entire body; implies body=true.; max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic articles get <id> --section <value>
```

##### `--max-chars`

Shared content character budget; truncated reports omitted content.

Type: `number`. Optional.

```bash title="terminal"
orc research aspic articles get <id> --max-chars <value>
```

### `authors list`

List editorial authors

```bash title="terminal"
orc research aspic authors list [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic authors list --page <value>
```

##### `--per-page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic authors list --per-page <value>
```

##### `--q`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic authors list --q <value>
```

##### `--slug`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic authors list --slug <value>
```

### `authors get`

Get ASPIC editorial author

```bash title="terminal"
orc research aspic authors get <id> [options]
```

### `categories list`

List categories

```bash title="terminal"
orc research aspic categories list [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic categories list --page <value>
```

##### `--per-page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic categories list --per-page <value>
```

##### `--q`

max 200 chars

Type: `string`. Optional.

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

##### `--slug`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic categories list --slug <value>
```

### `categories get`

Get ASPIC category

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

### `search`

Search services, articles, or authors

```bash title="terminal"
orc research aspic search [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic search --page <value>
```

##### `--per-page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic search --per-page <value>
```

##### `--q`

max 200 chars

Type: `string`. Required.

```bash title="terminal"
orc research aspic search --q <value>
```

##### `--type`

enum: service|article|article_author

Type: `string`. Optional.

```bash title="terminal"
orc research aspic search --type <value>
```

### `services list`

List services

```bash title="terminal"
orc research aspic services list [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic services list --page <value>
```

##### `--per-page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic services list --per-page <value>
```

##### `--q`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic services list --q <value>
```

##### `--slug`

max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic services list --slug <value>
```

##### `--category`

value

Type: `number`. Optional.

```bash title="terminal"
orc research aspic services list --category <value>
```

### `services get`

Get ASPIC service

```bash title="terminal"
orc research aspic services get <id> [options]
```

#### Unique options

##### `--body`

Explicitly request parsed content; identity only by default.; enum: true|false

Type: `string`. Optional.

```bash title="terminal"
orc research aspic services get <id> --body <value>
```

##### `--section`

Return matching headings instead of the entire body; implies body=true.; max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc research aspic services get <id> --section <value>
```

##### `--max-chars`

Shared content character budget; truncated reports omitted content.

Type: `number`. Optional.

```bash title="terminal"
orc research aspic services get <id> --max-chars <value>
```

## Examples

### Retrieve services in a category

```bash title="terminal"
orc research aspic services list --category 12 --per-page 10 --workspace YOUR_WORKSPACE_ID --json
```

*Retrieve services in a category*

### Retrieve only the pricing section

```bash title="terminal"
orc research aspic services get 25848 --section 料金 --max-chars 1000 --workspace YOUR_WORKSPACE_ID --json
```

*Retrieve only the pricing section*

## Results and workflow

Search ASPIC services and editorial articles through the distributed `orc` CLI. Sign in with `orc auth login` using a beta-approved account, or use an API key with the required scope, and select an accessible workspace.

Use `orc research aspic search` to search services, articles, or authors. Filter `orc research aspic services list` and `orc research aspic articles list` with a numeric `--category`.

`orc research aspic services get` and `orc research aspic articles get` return identity fields by default. Use `--body true` for parsed sections, tables, and links, or `--section` to select matching headings and their subsections. `--max-chars` sets the shared content budget. Check `truncated` for omitted content. Author details do not accept body options. Responses include the source URL and acquisition time; raw HTML is not returned.

Category `taxonomy_count` spans post types. Use the filtered service list's `pagination.total` for service counts. Reviews and report downloads are not supported.

See [ITreview](https://orchestor.io/docs/en/cli/research/itreview.md) and [IT-trend](https://orchestor.io/docs/en/cli/research/it-trend.md) for the other comparison sources.

## 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 aspic`:

- [`--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)
- [`--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)
