canonical: https://jentic.com/apis/juju.com/juju

# JuJu API

Jentic publishes the only available OpenAPI specification for JuJu API, keeping it validated and agent-ready. The JuJu API serves the public and partner-facing surfaces of the JuJu jobs platform: job search, single-job lookup, index counts, and click attribution for applications. It also exposes publisher feed syndication, CPA conversion postbacks, and the admin, sponsor, and publisher portals that manage offers, campaigns, publishers, sponsors, billing, and payouts. Job and feed endpoints use a per-publisher key, and the conversion callback uses a per-sponsor key.

## For AI agents

Search active job postings, look up jobs, and attribute application clicks on the JuJu jobs platform. Partner surfaces manage offers, campaigns, publishers, sponsors, billing, and conversions.

## Scope

Does not host resumes, run interviews, or process payroll. Use for job search, recruitment advertising, and application attribution only.

## Capabilities

- Search active job postings and retrieve a single job by its compound id
- Report the total count of indexed jobs and probe cache health
- Redirect and attribute application clicks through tracked links
- Post back confirmed job-application conversions for CPA billing
- Download publisher job syndication feeds
- Manage offers, campaigns, and segments for sponsors and publishers
- Administer publishers, sponsors, billing, invoices, and payouts

## Use cases

### AI Agent Job Search

An AI agent connected through Jentic can query the JuJu index for roles that match a candidate and return ranked postings. The agent searches for the job search operation, JuJu returns its input schema, and the agent calls it with a query and filters. This powers job-matching assistants without scraping a careers site.

Example prompt: Search active job postings for a role and location and return the top matches

### Click Attribution and Conversions

Redirect application clicks through JuJu's tracked links and post back confirmed conversions so sponsored jobs are billed on a cost-per-application basis. A partner integration can report applications as they are confirmed to keep spend and earnings reconciled.

Example prompt: Post back a confirmed application conversion for a sponsored job

### Publisher Feed Syndication

Download a publisher's job syndication feed file to republish listings on a partner site. Publishers pull their feed on a schedule and parse the postings, with API-usage reporting available to track volume.

Example prompt: Download a publisher's syndication feed and parse the job listings

### Campaign and Offer Management

Create and manage sponsor campaigns and the offers routed to them, including targeting segments and offer lists. An operations tool can set up a campaign, attach offers, and pause or resume delivery through the admin surface.

Example prompt: Create a campaign for a sponsor and add an offer to it

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/v1/jobs/search` | Search active job postings |
| GET | `/api/v1/jobs/{id}` | Retrieve a single job |
| GET | `/api/v1/jobs/count` | Total indexed job count |
| POST | `/api/v1/conversions` | Post back a job-application conversion |
| GET | `/api/v1/feeds/{slug}` | Download a publisher syndication feed |
| GET | `/admin/v1/campaigns` | List campaigns |
| POST | `/admin/v1/offers` | Create an offer |
| GET | `/admin/v1/reports/clicks` | Clicks report |

## Key resources

- **Jobs** — Job search, single-job lookup, counts, and cache health
- **Conversions** — CPA conversion postbacks from sponsors
- **Feeds** — Publisher job syndication feed files
- **Offers and Campaigns** — Offers, campaigns, segments, and offer lists
- **Billing** — Invoices, payments, payouts, and adjustments

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 56 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 73 / 100
  - Developer Experience & Jentic Compatibility: 62 / 100
  - AI-Readiness & Agent Experience: 50 / 100
  - Agent Usability: 43 / 100
  - Security: 60 / 100
  - AI Discoverability: 80 / 100
- **View full report:** https://jentic.com/apis/juju.com/juju/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the JuJu API by hand means handling per-publisher and per-sponsor Bearer keys, matching each key to the surface it unlocks (job endpoints versus the conversion callback), and knowing the X-API-Key header is not accepted. Through Jentic you install once, import JuJu from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** JuJu separates its read endpoints (job search, single job, counts, reports) from write operations across billing, offers, campaigns, and account management, so a rule can hold your agent to the job reads it needs. You choose the operations it may call, so issuing an invoice or deactivating a publisher is not included unless you add it.
- **Credential handling:** Your JuJu API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'search job postings' or 'post back a conversion', and Jentic returns the matching JuJu operation with its input schema so the agent calls the right endpoint without reading the docs.

## Related APIs

- **Adzuna** — Aggregated job listings and labour-market data.
- **The Muse** — Curated job postings and company profiles.
- **USAJOBS** — Official US federal government job postings.
- **Greenhouse** — Applicant tracking and hiring pipeline management.

## FAQ

### Why is there no official OpenAPI spec for JuJu API?

JuJu does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call JuJu API via structured tooling. It is validated against the live API and kept up to date. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### What authentication does the JuJu API use?

The JuJu API authenticates with Bearer keys per its OpenAPI spec: a publisher API key is required on the job and feed endpoints, and a separate per-sponsor callback key is used on the conversion postback. Keys are presented in the Authorization header, and the X-API-Key header is not accepted. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time.

### Can I search job postings with the JuJu API?

Yes. The job search endpoint returns active postings with filters, a single-job endpoint retrieves one by its compound id, and a count endpoint reports the total indexed jobs. Application clicks are redirected and attributed through tracked links.

### Is there a JuJu MCP server?

You don't need an MCP server to give your agent the JuJu API. Jentic connects it directly from the API Directory: import the API, store your key once, and your agent calls the job search and feed endpoints it needs.

### Can I limit what my agent is allowed to do with the JuJu API?

Yes. Write a rule that allows only the job search and read operations, so a job-matching agent can query postings while billing, campaign, and account changes stay out of reach, and every call it makes is logged.

### What are the rate limits for the JuJu API?

The OpenAPI spec does not publish specific rate limits. JuJu exposes an API-usage report you can read to track your consumption. Check with JuJu for the limits that apply to your publisher or sponsor key.

### How do I search jobs with the JuJu API through Jentic?

Search Jentic for an intent like 'search job postings', and it returns the JuJu job search operation with its input schema so your agent calls it with a query. Your stored key is injected at call time, so your agent reaches JuJu without ever handling the credential.