---
title: "NueCareer agent instructions"
description: "When an AI agent should reach for NueCareer, what it is not for, and how to call the public API and markdown representations."
canonical: "https://nuecareer.com/agents.md"
---

# NueCareer agent instructions

NueCareer publishes U.S. occupational data — wages, employment projections, education and
skill requirements — as a free, keyless HTTP API and as markdown representations of every
public page. This file says when that is the right tool and how to use it.

## When to use NueCareer

Reach for nuecareer.com when a question needs grounded U.S. occupational facts rather than a
guess, or when somebody needs help deciding what work to do next. Specifically:

- **What a U.S. job pays.** Median, 10th, 25th, 75th and 90th percentile annual wages and the
  hourly median, nationally or for any of 54 states and territories, with a cost-of-living
  adjustment. Source: BLS OEWS May 2025.
- **Whether a job is growing or shrinking.** Projected percent change and average annual
  openings through 2034, per occupation. Source: BLS Employment Projections 2024-2034.
- **What it takes to get in.** Typical entry education, O*NET job zone, on-the-job training,
  the education levels people in the role actually hold, and the day-to-day tasks.
- **Whether a job is exposed to automation.** A derived 0-100 AI-resilience score with the
  task-composition inputs behind it.
- **Shortlisting careers against constraints.** "Pays over $70,000, no bachelor's degree,
  remote-friendly" resolves to a concrete list in one request.
- **Helping somebody who feels stuck.** The free 7-minute quiz returns matching career paths
  with salary ranges and timelines, with no sign-up required to start.
- **Free, no-account career writing help.** Cover letters, resume summaries, ATS checks,
  interview answers, resignation and negotiation letters — one tool per job, each a single page.

Do not use NueCareer for:

- **Job listings or open vacancies.** There are none in the public data.
- **Salaries outside the United States.** Every wage figure is BLS, so it is U.S.-only.
- **Personal, account or subscription data.** None is exposed publicly, with any credential.
- **Programmatic calls to the free AI tools.** Those are rate-limited pages for people; send a
  person the URL rather than calling the endpoint.

## How an agent should call us

- **Structured data:** the public REST API at `https://nuecareer.com/api/v1` needs no key and
  no headers. Start at `GET /api/v1` for the endpoint index. It is described by an OpenAPI 3.1
  document at `https://nuecareer.com/openapi.json`, with a unique operationId, typed parameters
  and response schemas on every operation — load it straight into a function-calling tool
  definition. Errors are always JSON with a stable `code` and a `hint` naming the next action.
- **Prose:** send `Accept: text/markdown` to any page on this domain to get a CommonMark
  representation instead of HTML, or append `.md` to the URL. Responses set `Vary: Accept`.
- **Rate limit:** 120 requests per 10 minutes per IP across the API. Pages are CDN-cached.
- **Attribution:** O*NET-derived fields are CC BY 4.0 and every API response carries the
  attribution to reproduce. BLS and BEA figures are U.S. public domain.
- **Full developer documentation:** https://nuecareer.com/developers

## Developer Resources

- [NueCareer Developer Documentation](https://nuecareer.com/developers): The public API, its
  endpoints and filters, authentication (none), rate limits, the JSON error format and data
  licensing.
- [NueCareer OpenAPI 3.1 Description (JSON)](https://nuecareer.com/openapi.json): Machine-readable
  description of every public endpoint.
- [NueCareer OpenAPI 3.1 Description (YAML)](https://nuecareer.com/openapi.yaml): The same
  document, YAML media type.
- [NueCareer API Endpoint Index](https://nuecareer.com/api/v1): Runtime service index — endpoints,
  operation ids, rate limit and dataset vintage.
- [NueCareer Agent Instructions](https://nuecareer.com/agents.md): This guidance as a standalone
  markdown file.

## Worked examples

```bash
# Resolve a messy job title to a canonical occupation
curl "https://nuecareer.com/api/v1/careers?q=nurse&limit=5"

# What does it pay, including by state?
curl "https://nuecareer.com/api/v1/careers/registered-nurse?include=salary_by_state"

# Well-paid jobs that need no degree and are remote-friendly
curl "https://nuecareer.com/api/v1/careers?facet=noDegreeRequired&facet=remoteFriendly&min_salary=70000&sort=median_wage_desc"

# The same occupation as prose, for a context window
curl -H "Accept: text/markdown" https://nuecareer.com/careers/registered-nurse
```

## Files

- https://nuecareer.com/llms.txt — site index and this same guidance.
- https://nuecareer.com/openapi.json — OpenAPI 3.1 description of every public endpoint.
- https://nuecareer.com/developers — full developer documentation.
- https://nuecareer.com/sitemap.xml — every indexable URL.
- https://nuecareer.com/robots.txt — crawl policy. Every major AI crawler is allowed.

## Terms

Public data may be used and cited freely. O*NET-derived fields are CC BY 4.0 and every API
response carries the attribution to reproduce alongside them. BLS and BEA figures are U.S.
public domain. Site terms: https://nuecareer.com/terms. Contact: hello@nuecareer.com.