# Roster Job Search API

> Roster Job Search API is a paid API for AI agents from raoster.orbonomy.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Searches job listings and returns hiring data based on a keyword query and optional location filter

## Facts

- Endpoint: POST https://raoster.orbonomy.xyz/api/jobs
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/roster-job-search-api-9e1aa14a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qxa3VdSIQIzokYFXtSZbz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability roster-job-search-api-9e1aa14a -d '<json body>'
```

Example prompt: Search Roster for software engineer jobs in Austin, Texas and show me what's available.

## When to prefer this

Use this endpoint when an AI agent needs to search for job listings programmatically without API keys or subscriptions, paying per request in USDC via x402. Best suited for on-demand job discovery tasks where the agent has a specific query and optional location to search against.

## Known failure modes

- Payment not sent or insufficient USDC — 402 Payment Required response
- Missing or malformed query field — may return empty results or error
- Location not recognized — may return no results or global listings
- Service unavailable — 5xx error with no job data returned
- Rate limiting or quota exceeded at the facilitator level

## How this service works

Job listings and hiring data for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.

## Output

Returns a success flag and a data object containing job listings and hiring information matching the query and location criteria.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "query"
  },
  "location": {
   "type": "string",
   "description": "location"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/roster-job-search-api-9e1aa14a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from raoster.orbonomy.xyz](https://www.zero.xyz/host/raoster.orbonomy.xyz/llms.txt)