# Jobs Search

> Jobs Search is a paid API for AI agents from jobs.use.x402atlas.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Search for current job openings by role, skill, or company, returning listings with location, salary, schedule, qualifications, and direct application links.

## Facts

- Endpoint: GET https://jobs.use.x402atlas.com/search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jobs-search-19799d8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zCQD6Vhn9lFmcR2BroKwX

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 jobs-search-19799d8d
```

Example prompt: Can you find me current software engineer job openings in Austin, Texas? I'm especially interested in roles at mid-to-large tech companies — show me listings with salary info and direct apply links.

## When to prefer this

Use this endpoint when an agent needs to surface real, current job postings with rich structured metadata — salary, schedule, qualifications, and apply links — rather than just a list of company names or generic career page URLs. It is well-suited for job-hunting assistants, career advisors, or recruiting automation workflows where the agent needs to present actionable, ready-to-apply listings to a user. Prefer it over general web search when structured job data (salary bands, schedule type, qualifications) is needed in a consistent format.

## Known failure modes

- Empty or whitespace query returns a sample/demo result set rather than real matches (indicated by a 'note' field in the response)
- No results found for highly specific or obscure role/location combinations
- Invalid country or language code (must be valid 2-letter ISO codes) may return unexpected results or an error
- Query exceeding 200 characters is rejected by schema validation
- Stale listings may appear if the underlying job board data is not refreshed frequently

## How this service works

Job search — find current openings by role, skill or company with location, salary, schedule, qualifications and direct application links.

## Output

Returns a list of job postings each containing: job title, company name, location, salary (if available), schedule type (e.g. full-time, part-time), qualifications summary, job description highlights, original job board source, posting date, and an array of direct application links with labels. Also includes the query string, search timestamp, and an optional pagination token for fetching more results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1,
       "description": "Role, skill, company or other free-text job search"
      },
      "country": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Two-letter country code"
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Two-letter result language"
      },
      "location": {
       "type": "string",
       "maxLength": 120,
       "description": "City, region or country used to localize results"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "searched_at",
      "jobs"
     ],
     "properties": {
      "jobs": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "title"
        ],
        "properties": {
         "title": {
          "type": "string"
         },
         "salary": {
          "type": "string"
         },
         "source": {
          "type": "string",
          "description": "Original job board or employer source"
         },
         "company": {
          "type": "string"
         },
         "location": {
          "type": "string"
         },
         "position": {
          "type": "integer"
         },
         "posted_at": {
          "type": "string"
         },
         "highlights": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "items": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "title": {
             "type": "string"
            }
           }
          }
         },
         "description": {
          "type": "string"
         },
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobs": [
   {
    "title": "Software Engineer",
    "salary": "$140,000–$180,000 a year",
    "source": "Company careers",
    "company": "Example Technology",
    "location": "New York, NY",
    "position": 1,
    "posted_at": "1 day ago",
    "description": "Build reliable software products with a collaborative engineering team.",
    "apply_options": [
     {
      "link": "https://example.com/careers/software-engineer",
      "title": "Apply on company site"
     }
    ],
    "schedule_type": "Full-time"
   }
  ],
  "query": "software engineer",
  "searched_at": "2026-07-29T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jobs-search-19799d8d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jobs.use.x402atlas.com](https://www.zero.xyz/host/jobs.use.x402atlas.com/llms.txt)