> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Connect AI agents, n8n, Make, and other automation tools to Mokaru

## Overview

The Mokaru API lets AI agents and automation platforms search jobs and manage applications on your behalf. Build custom job search workflows, automate application tracking, or let your AI assistant handle the heavy lifting.

### Popular integrations

<CardGroup cols={3}>
  <Card title="AI Agents" icon="robot">
    Claude Desktop, OpenAI GPTs, OpenClaw (via ClawdHub skill), custom AI assistants, LangChain agents
  </Card>

  <Card title="Automation" icon="arrows-spin">
    n8n, Make (Integromat), Zapier, Pipedream, ActivePieces
  </Card>

  <Card title="Custom Tools" icon="code">
    Any HTTP client, Python scripts, browser extensions, CLI tools
  </Card>
</CardGroup>

<Note>
  API keys require a **Plus plan**. [Upgrade here](https://app.mokaru.ai/billing).
</Note>

## Base URL

```
https://api.mokaru.ai
```

All endpoints are prefixed with `/v1`.

## Quick Start

### Using curl

```bash theme={null}
curl -X POST "https://api.mokaru.ai/v1/jobs/search" \
  -H "Authorization: Bearer mk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"query": "software engineer"}'
```

### Using Python

```python theme={null}
import requests

headers = {"Authorization": "Bearer mk_your_api_key_here"}

# Search for jobs
jobs = requests.post(
    "https://api.mokaru.ai/v1/jobs/search",
    headers=headers,
    json={"query": "data scientist", "remote": True}
).json()

# Save a job to your tracker
for job in jobs["data"][:5]:
    requests.post(
        "https://api.mokaru.ai/v1/tracker/applications",
        headers=headers,
        json={
            "jobTitle": job["title"],
            "company": job["company"],
            "jobUrl": job["applyLink"],
            "jobListingId": job["id"]
        }
    )
```

### Using n8n

1. Add an **HTTP Request** node
2. Set method to `POST` and URL to `https://api.mokaru.ai/v1/jobs/search`
3. Add header: `Authorization: Bearer mk_your_api_key_here`
4. Set body to JSON with your search query
5. Connect to your workflow (e.g. daily job search, Slack notifications, spreadsheet export)

### Using OpenClaw

Mokaru is available as a skill on [ClawdHub](https://clawdhub.com). Install the Mokaru skill in OpenClaw to search jobs and manage applications directly from your AI agent.

## Endpoints

<CardGroup cols={2}>
  <Card title="Search Jobs" icon="magnifying-glass" href="/api-reference/endpoint/search-jobs">
    Search job listings from the Mokaru database
  </Card>

  <Card title="Create Application" icon="plus" href="/api-reference/endpoint/create-application">
    Add a job to your application tracker
  </Card>

  <Card title="List Applications" icon="list" href="/api-reference/endpoint/list-applications">
    View your tracked applications
  </Card>

  <Card title="Contacts" icon="address-book" href="/api-reference/endpoint/list-contacts">
    Manage your networking contacts
  </Card>

  <Card title="Experiences" icon="briefcase" href="/api-reference/endpoint/list-experiences">
    Manage your work experiences
  </Card>

  <Card title="Education" icon="graduation-cap" href="/api-reference/endpoint/list-education">
    Manage your education history
  </Card>

  <Card title="Skills" icon="star" href="/api-reference/endpoint/list-skills">
    Manage your skills
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    API keys, scopes, and rate limits
  </Card>
</CardGroup>

## Use Cases

<AccordionGroup>
  <Accordion title="Daily job search with AI agents">
    Set up a Claude Desktop, OpenAI GPT, or OpenClaw agent to search for jobs matching your criteria every morning and add the best matches to your tracker automatically. The Mokaru skill on ClawdHub makes this a one-click setup.
  </Accordion>

  <Accordion title="n8n automation workflow">
    Build an n8n workflow that searches for new jobs daily, filters by salary and location, sends matches to Slack, and saves them to your Mokaru tracker.
  </Accordion>

  <Accordion title="Custom job aggregator">
    Use the API to build a personal job aggregator that pulls from Mokaru's database of thousands of listings and combines them with other sources.
  </Accordion>

  <Accordion title="Application tracking sync">
    Keep an external spreadsheet or Notion database in sync with your Mokaru application tracker using the List Applications endpoint.
  </Accordion>
</AccordionGroup>