# Company jobs

> List a company’s open job postings, by its domain or name.

`company_jobs` lists a company’s open job postings, by its domain or name: title, location, posting date and link. Give `domain` or `name`; the domain is more precise.

Call it with `POST /v1/tools/company_jobs`, or as `company_jobs` over [MCP](https://clonvo.com/docs/mcp.md). It runs on Clonvo credits only.

## Arguments

-   `domain` string
    
    The company’s website domain, e.g. stripe.com. Use a bare domain such as example.com (no scheme, path or wildcard).
    
-   `name` string
    
    The company’s name, when you don’t have its domain.
    
-   `max_results` integer
    
    How many job postings to return (1–25, default 10).
    

## Example

```bash
curl https://api.clonvo.com/v1/tools/company_jobs \
  -H "Authorization: Bearer $CLONVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "arguments": { "domain": "weaviate.io", "max_results": 2 } }'
```

```json
{
  "id": "gen-01M6A3F9H1K3M5P7R9T1V3X5Z7",
  "tool": "company_jobs",
  "provider": "clonvo",
  "result": {
    "jobs": [
      {
        "title": "Senior Software Engineer, Database Core",
        "url": "https://weaviate.io/company/careers",
        "company": "Weaviate",
        "location": "Remote, Europe",
        "posted_at": "2026-10-28T00:00:00.000Z",
        "description": "Work on Weaviate’s storage engine and query planner in Go…"
      },
      {
        "title": "Developer Advocate",
        "url": "https://weaviate.io/company/careers",
        "company": "Weaviate",
        "location": "Remote, United States",
        "posted_at": "2026-10-21T00:00:00.000Z",
        "description": null
      }
    ]
  },
  "usage": { "cost": 0.018, "charged": 0.01836, "is_byok": false }
}
```

## Result

| Field | Description |
| --- | --- |
| `jobs[]` | The open postings, each with `title`, `url`, `company`, `location`, `posted_at` and `description`. Fields that aren’t known are `null`. |
| `notes` | Present when the provider handled an argument differently. |

The fields around `result` (`id`, `tool`, `provider`, `usage`) are the same for every tool; see [Calling tools](https://clonvo.com/docs/calling-tools.md#response).

## Notes

-   Job postings are priced per posting returned, so `max_results` sets the price. On Clonvo credits the cap for the call grows with `max_results`; see [Tool billing](https://clonvo.com/docs/tool-billing.md#on-clonvo-credits).