---
title: research yc
description: Retrieve companies, founders, launches, and blog posts from the
  public Y Combinator website.
canonical_url: https://orchestor.io/docs/en/cli/research/yc
markdown_url: https://orchestor.io/docs/en/cli/research/yc.md
contentType: reference
---

# research yc

Retrieve companies, founders, launches, and blog posts from the public Y Combinator website. This is a public-page adapter, not an official partner API.

## Usage

```bash title="terminal"
orc research yc companies list --industry b2b --page 1 --workspace YOUR_WORKSPACE_ID --format json
```

*Retrieve the first page of B2B companies*

## Subcommands

### `companies list`

List YC companies by industry

```bash title="terminal"
orc research yc companies list [options]
```

#### Unique options

##### `--industry`

Source slug from a list response; not a URL.; max 200 chars

Type: `string`. Required.

```bash title="terminal"
orc research yc companies list --industry <value>
```

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research yc companies list --page <value>
```

### `companies get`

Get YC company

```bash title="terminal"
orc research yc companies get <slug> [options]
```

### `companies founders list`

List YC company founders

```bash title="terminal"
orc research yc companies founders list <slug> [options]
```

### `launches list`

List YC launches

```bash title="terminal"
orc research yc launches list [options]
```

#### Unique options

##### `--page`

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

Type: `number`. Optional.

```bash title="terminal"
orc research yc launches list --page <value>
```

### `launches get`

Get YC launch

```bash title="terminal"
orc research yc launches get <slug> [options]
```

### `posts list`

List YC blog posts

```bash title="terminal"
orc research yc posts list [options]
```

#### Unique options

##### `--page`

value

Type: `number`. Optional.

```bash title="terminal"
orc research yc posts list --page <value>
```

### `posts get`

Get YC blog post

```bash title="terminal"
orc research yc posts get <slug> [options]
```

## Results and workflow

Uses the existing public website acquisition adapter, not an official partner API. Requires read scope and an accessible Workspace.

JSON output retains records in `data.data`, source URL/time in `data.source`, and continuation in `data.pagination`. Detail operations return an object; collections return arrays. Source field names and additional fields are preserved; credential-like fields and URL query values are redacted. Missing values are unknown, not zero. Sanitize HTML before rendering.

Each call retrieves one page. Pass query values from `pagination.next_url` to continue. `orc research yc companies list` and `orc research yc posts list` use one-based `--page` values. `orc research yc launches list` uses zero-based `--page` values. `reported_total` is source-reported, not an exhaustive coverage guarantee. YC founders are limited to those embedded in the selected company profile. Blog featured posts are not injected into the paginated list.

No whole-directory sync, persistence or paid provider is used. `--page-all` is unavailable. Use `--dry-run` to preview and `--raw` to remove the CLI envelope. Exit codes: success 0, API/auth/network failure 1, input error 2. HTTP 404 means unavailable source target, 429 source rate limiting, 502 acquisition/contract failure, and 504 timeout.

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

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