Y Combinator · Job search
ycombinator-com/companies/job_searchFind companies, people and contact details with Y Combinator · Job search from Alexandria through one Spiral API key. Search public jobs across all YC companies. Title words (e.g. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
url | text | — | A pasted https://www.ycombinator.com/jobs, /jobs/role/<role>[/<location>] or /jobs/location/<location> URL. |
role | one of eng, design, product, science, sales, marketing, support, operations, recruiting, finance, legal | — | Source role code. |
type | one of Full-time, Part-time, Internship, Contract | — | Source job type. Some internships are typed Full-time at the source; query intern catches those by title. |
query | text | — | Title words; each must appear in the job title slug of the job URL (plural and -ship forms count, so intern matches internship). Company names and slugs are not matched; use the jobs function for one company. Omit to scan all jobs newest first. |
offset | number 0 to 10000 | 0 | Candidate offset; pass next_offset from the previous call. The scan resumes right after the last candidate the previous call read, so nothing is skipped or repeated. |
remote | one of remote, hybrid, onsite | — | Legacy exact match on the derived remote mode: remote is the same as remote_only true (fully remote roles, including country-restricted ones such as Remote (US)); hybrid and onsite match only that mode. Prefer remote_allowed or remote_only. |
country | text | — | ISO-3166-1 alpha-2 code from the derived countries. Pattern: ^[A-Z]{2}$. |
location | text | — | Case-insensitive text in the source location (e.g. new york), or a country name matched against derived countries. |
page_size | number 1 to 50 | — | Records per call. Default 10 for title / sitemap scans and 50 (the whole page) for listing pages. |
remote_only | true or false | — | true keeps fully remote roles only (derived remote, including country- or region-restricted remote such as Remote (US) or Remote - Canada); false keeps hybrid and on-site roles. |
remote_allowed | true or false | — | true keeps roles that accept remote work (derived remote or hybrid, i.e. remote is an option); false keeps on-site-only roles. Roles whose location does not parse are excluded either way. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "ycombinator-com/companies/job_search",
"input": {
"url": "<url>"
}
}'Frequently asked questions
How much does Y Combinator · Job search cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Y Combinator · Job search through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "ycombinator-com/companies/job_search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use Y Combinator · Job search?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use Y Combinator · Job search?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.