--- title: research zenn description: Research Zenn articles, books and scraps. canonical_url: https://orchestor.io/docs/en/cli/research/zenn markdown_url: https://orchestor.io/docs/en/cli/research/zenn.md contentType: reference --- # research zenn `orc research zenn` searches Zenn articles, books and scraps by author, topic or publication. Follow owner and slug values to retrieve details, and inspect search counts or homepage sections. Authenticate the CLI and select an accessible Workspace. Use `--workspace` to set the scope for this call. ## Usage ```bash title="terminal" orc research zenn articles list --q "生成AI" --workspace --json ``` *Find articles about a topic.* ## Subcommands ### `articles list` Search articles and filter by author, topic, publication and native order. `--publication-name` uses the publication name, not its display name. ```bash title="terminal" orc research zenn articles list [options] ``` #### Unique options ##### `--q` Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars Type: `string`. Optional. ```bash title="terminal" orc research zenn articles list --q ``` ##### `--page` One-based page number. Prefer the returned pagination.next_url. Type: `number`. Optional. ```bash title="terminal" orc research zenn articles list --page ``` ##### `--topic-name` Zenn topic name, not its numeric ID. URL-encode the path segment.; max 200 chars Type: `string`. Optional. ```bash title="terminal" orc research zenn articles list --topic-name ``` ##### `--username` Filter by the Zenn author username. Type: `string`. Optional. ```bash title="terminal" orc research zenn articles list --username ``` ##### `--order` Native Zenn order. Defaults to latest. daily is Trending; alltime is Alltime; recent is Recent. Scraps do not support recent.; enum: latest|daily|alltime|recent Type: `string`. Optional. ```bash title="terminal" orc research zenn articles list --order ``` ##### `--publication-name` Filter articles by publication name, not display name. Type: `string`. Optional. ```bash title="terminal" orc research zenn articles list --publication-name ``` ### `articles get` Retrieve an article using the owner and slug from its URL or returned `api_url`, rather than a numeric ID. ```bash title="terminal" orc research zenn articles get [options] ``` ### `books list` Search books and filter by author, topic and native order. ```bash title="terminal" orc research zenn books list [options] ``` #### Unique options ##### `--q` Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars Type: `string`. Optional. ```bash title="terminal" orc research zenn books list --q ``` ##### `--page` One-based page number. Prefer the returned pagination.next_url. Type: `number`. Optional. ```bash title="terminal" orc research zenn books list --page ``` ##### `--topic-name` Zenn topic name, not its numeric ID. URL-encode the path segment.; max 200 chars Type: `string`. Optional. ```bash title="terminal" orc research zenn books list --topic-name ``` ##### `--username` Filter by the Zenn author username. Type: `string`. Optional. ```bash title="terminal" orc research zenn books list --username ``` ##### `--order` Native Zenn order. Defaults to latest. daily is Trending; alltime is Alltime; recent is Recent. Scraps do not support recent.; enum: latest|daily|alltime|recent Type: `string`. Optional. ```bash title="terminal" orc research zenn books list --order ``` ### `books get` Retrieve a book using the owner and slug from its URL or returned `api_url`, rather than a numeric ID. ```bash title="terminal" orc research zenn books get [options] ``` ### `map` Discover Zenn retrieval operations and content entry points. ```bash title="terminal" orc research zenn map [options] ``` ### `publications list` Search publications using the required `--q` search text. ```bash title="terminal" orc research zenn publications list [options] ``` #### Unique options ##### `--q` Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars Type: `string`. Required. ```bash title="terminal" orc research zenn publications list --q ``` ##### `--page` One-based page number. Prefer the returned pagination.next_url. Type: `number`. Optional. ```bash title="terminal" orc research zenn publications list --page ``` ### `publications get` Retrieve a publication by its name, not its display name or numeric ID. ```bash title="terminal" orc research zenn publications get [options] ``` ### `scraps list` Search scraps by author or topic. Supported order values are `latest`, `daily` and `alltime`; scraps do not support `recent`. ```bash title="terminal" orc research zenn scraps list [options] ``` #### Unique options ##### `--q` Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars Type: `string`. Optional. ```bash title="terminal" orc research zenn scraps list --q ``` ##### `--page` One-based page number. Prefer the returned pagination.next_url. Type: `number`. Optional. ```bash title="terminal" orc research zenn scraps list --page ``` ##### `--topic-name` Zenn topic name, not its numeric ID. URL-encode the path segment.; max 200 chars Type: `string`. Optional. ```bash title="terminal" orc research zenn scraps list --topic-name ``` ##### `--username` Filter by the Zenn author username. Type: `string`. Optional. ```bash title="terminal" orc research zenn scraps list --username ``` ##### `--order` Native scrap ordering: latest, daily or alltime. Defaults to latest. Keep the value unchanged when following pagination.; enum: latest|daily|alltime Type: `string`. Optional. ```bash title="terminal" orc research zenn scraps list --order ``` ### `scraps get` Retrieve a scrap using the owner and slug from its URL or returned `api_url`, rather than a numeric ID. ```bash title="terminal" orc research zenn scraps get [options] ``` ### `search counts get` Retrieve source search counts for `--q`. Counts do not measure search demand or article quality. ```bash title="terminal" orc research zenn search counts get [options] ``` #### Unique options ##### `--q` Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars Type: `string`. Required. ```bash title="terminal" orc research zenn search counts get --q ``` ### `topics list` Browse topics using search text and page numbers. ```bash title="terminal" orc research zenn topics list [options] ``` #### Unique options ##### `--q` Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars Type: `string`. Optional. ```bash title="terminal" orc research zenn topics list --q ``` ##### `--page` One-based page number. Prefer the returned pagination.next_url. Type: `number`. Optional. ```bash title="terminal" orc research zenn topics list --page ``` ### `topics get` Retrieve a topic by name rather than numeric ID. ```bash title="terminal" orc research zenn topics get [options] ``` ### `trends list` Retrieve sections displayed on the Zenn homepage. ```bash title="terminal" orc research zenn trends list [options] ``` ### `users list` Search Zenn users using the required `--q` search text. ```bash title="terminal" orc research zenn users list [options] ``` #### Unique options ##### `--q` Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars Type: `string`. Required. ```bash title="terminal" orc research zenn users list --q ``` ##### `--page` One-based page number. Prefer the returned pagination.next_url. Type: `number`. Optional. ```bash title="terminal" orc research zenn users list --page ``` ### `users get` Retrieve public information for a Zenn username. ```bash title="terminal" orc research zenn users get [options] ``` ## Examples ### Retrieve an article using its URL identifiers. ```bash title="terminal" orc research zenn articles get --workspace --json ``` *Retrieve an article using its URL identifiers.* ## Output and continuation List calls retrieve one source page. Follow the query values in `pagination.next_url` using the corresponding flags, keeping filters unchanged. Unknown continuation does not establish completeness. Automatic traversal with `--page-all` is unavailable. With `--json`, the full API response is retained inside the CLI `data` envelope. Records are in `data.data`, continuation in `data.pagination`, and provenance in `data.source`. `--raw` removes the CLI envelope; `--field data` selects API data. Missing and null values do not mean zero. ## Identifiers and native order For details, owner is the first source URL segment and slug is the content slug. Use topic names, usernames and publication names rather than numeric IDs or display names. Articles and books support `latest`, `daily`, `alltime` and `recent`; scraps do not support `recent`. Preserve ordering when continuing. ## Permissions API keys require read scope. Provider credentials are managed by the server. ## Global Options The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc research zenn`: - [`--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). ## Related commands - Research overview - [Global options](https://orchestor.io/docs/en/cli/global-flags.md) --- [Documentation index](https://orchestor.io/docs/llms.txt)