Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/mauroperez055/infoJobs/llms.txt

Use this file to discover all available pages before exploring further.

The GET /jobs endpoint returns a paginated collection of job listings from the in-memory store. You can narrow results with optional query parameters that filter by free-text search, technology stack, experience level, or exact title match. The response always includes metadata about the current page so clients can implement forward and backward navigation.
GET /jobs

Query Parameters

text
string
Free-text search term. Matches against both job title (titulo) and description (descripcion) using a case-insensitive substring comparison.
title
string
Filter by exact title match. Compared case-insensitively against the titulo field.
level
string
Accepted by the query parser and forwarded to the model, but the current JobModel.getAll implementation does not apply a filter on this parameter — all jobs are returned regardless of the value supplied. This filter is reserved for a future implementation that will match against the data.nivel field.
technology
string
Filter by technology name (e.g. react, node, typescript). Must exactly match one of the strings in the job’s data.technology array.
limit
number
default:"10"
Maximum number of job records to return in a single page. Must be a positive integer.
offset
number
default:"0"
Number of records to skip before beginning the result set. Used together with limit to paginate through all results.

Response Fields

total
number
Total number of jobs that matched the applied filters, regardless of limit and offset. Use this value to calculate total pages.
limit
number
The limit value that was applied to this response.
offset
number
The offset value that was applied to this response.
data
array
Array of Job objects matching the query.

Example

Fetch the first 5 jobs tagged with the react technology:
curl "http://localhost:1234/jobs?technology=react&limit=5"
{
  "total": 38,
  "limit": 5,
  "offset": 0,
  "data": [
    {
      "id": "7a4d1d8b-1e45-4d8c-9f1a-8c2f9a9121a4",
      "titulo": "Frontend Developer Senior",
      "empresa": "Tech Solutions Inc.",
      "ubicacion": "Remote",
      "descripcion": "We are looking for an experienced React developer...",
      "data": {
        "technology": ["react", "typescript", "node"],
        "modalidad": "remoto",
        "nivel": "senior"
      },
      "content": {
        "description": "Full description of the role...",
        "responsibilities": "Lead frontend architecture...",
        "requirements": "5+ years with React...",
        "about": "Tech Solutions Inc. is a..."
      }
    }
  ]
}

Build docs developers (and LLMs) love