--- title: research qiita description: Research Qiita articles, tags and users. canonical_url: https://orchestor.io/docs/en/cli/research/qiita markdown_url: https://orchestor.io/docs/en/cli/research/qiita.md contentType: reference --- # research qiita `orc research qiita` finds articles with native Qiita search expressions and follows tags or users to public articles and comments. Inspect trends or native rankings, then use item IDs to retrieve articles. Authenticate the CLI and select an accessible Workspace. Use `--workspace` to set the scope for this call. ## Usage ```bash title="terminal" orc research qiita items list --query "tag:Python" --per-page 20 --workspace --json ``` *Find articles tagged Python.* ## Subcommands ### `items list` List Qiita articles and filter them with native expressions such as `tag:Python` in `--query`. ```bash title="terminal" orc research qiita items list [options] ``` #### Unique options ##### `--page` Qiita API v2 page number, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita items list --page ``` ##### `--per-page` Requested items per page, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita items list --per-page ``` ##### `--include-native` Include original source list fields. Detail endpoints always include native data.; enum: true|false Type: `string`. Optional. ```bash title="terminal" orc research qiita items list --include-native ``` ##### `--query` Native Qiita item search expression.; max 1000 chars Type: `string`. Optional. ```bash title="terminal" orc research qiita items list --query ``` ### `items get` Retrieve an article using its 20-character item ID, not its URL. ```bash title="terminal" orc research qiita items get [options] ``` ### `items comments list` Retrieve comments for an item ID. ```bash title="terminal" orc research qiita items comments list [options] ``` ### `map` Discover Qiita operations for articles, tags and users. ```bash title="terminal" orc research qiita map [options] ``` ### `rankings tags list` Retrieve weekly or monthly tag rankings in the source’s native order and window. ```bash title="terminal" orc research qiita rankings tags list [options] ``` #### Unique options ##### `--scope` Native Qiita ranking period. all is available for users only.; enum: weekly|monthly Type: `string`. Optional. ```bash title="terminal" orc research qiita rankings tags list --scope ``` ### `rankings users list` Retrieve weekly, monthly or all-time user rankings. Available periods differ from tag rankings. ```bash title="terminal" orc research qiita rankings users list [options] ``` #### Unique options ##### `--scope` Native Qiita ranking period. all is available for users only.; enum: weekly|monthly|all Type: `string`. Optional. ```bash title="terminal" orc research qiita rankings users list --scope ``` ### `tags list` Browse tags. Use `--sort count` for item counts or `--sort name` for names; omission uses Qiita’s newest order. ```bash title="terminal" orc research qiita tags list [options] ``` #### Unique options ##### `--page` Qiita API v2 page number, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita tags list --page ``` ##### `--per-page` Requested items per page, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita tags list --per-page ``` ##### `--sort` Native tag ordering by item count or name. Omit to use Qiita newest order.; enum: count|name Type: `string`. Optional. ```bash title="terminal" orc research qiita tags list --sort ``` ### `tags get` Retrieve public information for a tag name. ```bash title="terminal" orc research qiita tags get [options] ``` ### `tags items list` Retrieve one page of articles associated with a tag. ```bash title="terminal" orc research qiita tags items list [options] ``` #### Unique options ##### `--page` Qiita API v2 page number, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita tags items list --page ``` ##### `--per-page` Requested items per page, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita tags items list --per-page ``` ##### `--include-native` Include original source list fields. Detail endpoints always include native data.; enum: true|false Type: `string`. Optional. ```bash title="terminal" orc research qiita tags items list --include-native ``` ### `trends list` Retrieve articles appearing in Qiita’s native trends. ```bash title="terminal" orc research qiita trends list [options] ``` #### Unique options ##### `--include-native` Include original source list fields. Detail endpoints always include native data.; enum: true|false Type: `string`. Optional. ```bash title="terminal" orc research qiita trends list --include-native ``` ### `users get` Retrieve a public profile by username rather than `permanent_id`. ```bash title="terminal" orc research qiita users get [options] ``` ### `users items list` List public articles by username. ```bash title="terminal" orc research qiita users items list [options] ``` #### Unique options ##### `--page` Qiita API v2 page number, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita users items list --page ``` ##### `--per-page` Requested items per page, 1–100. Type: `number`. Optional. ```bash title="terminal" orc research qiita users items list --per-page ``` ##### `--include-native` Include original source list fields. Detail endpoints always include native data.; enum: true|false Type: `string`. Optional. ```bash title="terminal" orc research qiita users items list --include-native ``` ## Examples ### Read tag rankings. ```bash title="terminal" orc research qiita rankings tags list --scope weekly --workspace --json ``` *Read tag rankings.* ## 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. ## Search and page settings Article searches accept native Qiita expressions. `--page` ranges from 1 to 100; `--per-page` ranges from 1 to 100 and defaults to 20. Use `--include-native true` for original list fields; detail responses always include native data. Rankings retain the source window and size without an exhaustive-coverage guarantee. ## 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 qiita`: - [`--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)