# searchJobListings

**Identifier:** `crustdata_searchJobListings`

**Provider:** [Crustdata](https://kirha.com/providers/crustdata.md)

Search job listings by hiring company, title, category, location, workplace type, posting date and company size, newest first, optionally with the full description. Use it to find open roles or see what a company is recruiting for.

## Run it with the CLI

```bash
kirha tools run crustdata_searchJobListings \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "crustdata_searchJobListings",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "description": "Job category, e.g., Engineering, Sales, Marketing, Finance",
      "minLength": 2,
      "type": "string"
    },
    "city": {
      "minLength": 2,
      "type": "string"
    },
    "company": {
      "description": "Hiring company website domain or name, e.g., mistral.ai",
      "minLength": 2,
      "type": "string"
    },
    "country": {
      "description": "Full country name of the job, e.g., France",
      "minLength": 4,
      "type": "string"
    },
    "cursor": {
      "description": "nextCursor of the previous page",
      "minLength": 8,
      "type": "string"
    },
    "includeDescription": {
      "description": "Adds the posting text and limits the page to 10 listings",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "maxCompanyHeadcount": {
      "maximum": 9007199254740991,
      "minimum": 1,
      "type": "integer"
    },
    "minCompanyHeadcount": {
      "maximum": 9007199254740991,
      "minimum": 1,
      "type": "integer"
    },
    "postedSince": {
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "title": {
      "description": "Words of the job title, e.g., data engineer",
      "minLength": 2,
      "type": "string"
    },
    "workplace": {
      "enum": [
        "On-site",
        "Hybrid",
        "Remote"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "jobs": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "companyDomain": {
            "type": "string"
          },
          "companyEmployees": {
            "type": "number"
          },
          "country": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "employmentType": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "postedOn": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "workplace": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "nextCursor": {
      "type": "string"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "total",
    "jobs"
  ],
  "type": "object"
}
```

-----

[All Crustdata tools](https://kirha.com/providers/crustdata.md) · [< Back to tools list](https://kirha.com/tools.md)