# beyourspace Job Offer Requirements Extractor

> beyourspace Job Offer Requirements Extractor is a paid API for AI agents from api.beyourspace.es, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-18).

Parses free-text job offer descriptions into structured mandatory/desirable requirements, years of experience, work modality, and location for automated filtering by AI agents.

## Facts

- Endpoint: POST https://api.beyourspace.es/v1/extraer-requisitos-oferta
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beyourspace-job-offer-requirements-extractor-8d93f48a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RMj-sru7j6RNOAI-4zi8i

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 beyourspace-job-offer-requirements-extractor-8d93f48a -d '<json body>'
```

Example prompt: Parse this job offer text and extract all the mandatory and desirable requirements, how many years of experience are needed, whether it's remote or on-site, and the location: 'Se busca desarrollador backend con 3 años de experiencia en Python, valorable conocimiento de AWS, modalidad híbrida en Madrid.'

## When to prefer this

Choose this endpoint when you need to convert raw, unstructured job offer text into machine-readable structured fields (requirements, experience, modality, location) for recruitment automation, ATS intake, or agent-based candidate matching. Particularly suited for Spanish-language job offers and pipelines running on the beyourspace platform. Prefer this over generic NLP or LLM calls when you need a consistent, predictable JSON schema optimized for recruiting workflows.

## Known failure modes

- Input text is too long (exceeds 20,000 characters) — returns a 400 validation error
- Text contains no discernible job offer structure — returns empty or null fields
- Language not supported or ambiguous — may produce low-quality extraction
- Payment not completed — returns 402 Payment Required
- Malformed request body — returns 400 with schema validation error

## How this service works

Endpoints de pago por uso para extraer datos de texto, leer páginas públicas y transformar CSV en JSON normalizado. Sin cuentas ni permanencia, con esquemas documentados y ejemplos ejecutables.

## Output

A structured JSON object containing arrays of mandatory and desirable requirements, an integer for years of experience required, a work modality field (remote/hybrid/on-site), and a location string — ready for downstream filtering or matching by an AI agent or ATS.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "maxLength": 20000,
   "description": "Texto libre, sin datos personales"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beyourspace-job-offer-requirements-extractor-8d93f48a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.beyourspace.es](https://www.zero.xyz/host/api.beyourspace.es/llms.txt)
