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
orc research yc companies list --industry b2b --page 1 --workspace YOUR_WORKSPACE_ID --format jsonRetrieve the first page of B2B companies
Subcommands
companies list
List YC companies by industry
orc research yc companies list [options]Unique options
--industry
Source slug from a list response; not a URL.; max 200 chars
Type: string. Required.
orc research yc companies list --industry <value>--page
value
Type: number. Optional.
orc research yc companies list --page <value>companies get
Get YC company
orc research yc companies get <slug> [options]companies founders list
List YC company founders
orc research yc companies founders list <slug> [options]launches list
List YC launches
orc research yc launches list [options]Unique options
--page
(use "null" or "reset" to clear)
Type: number. Optional.
orc research yc launches list --page <value>launches get
Get YC launch
orc research yc launches get <slug> [options]posts list
List YC blog posts
orc research yc posts list [options]Unique options
--page
value
Type: number. Optional.
orc research yc posts list --page <value>posts get
Get YC blog post
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 can be used with orc research yc:
For details and examples, see global options.