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

# Zapier

> Start a Zap when a new job matching your filters is indexed, or search jobs and look up companies as a step in one.

The Jobo app for Zapier has one trigger and four searches.

> [!NOTE]
>
> The app is built and tested but not registered with Zapier yet, so it does not appear in Zapier's app directory today.

| | Name | What it does | Billed as |
| - | - | - | - |
| Trigger | **New Job** | Starts a Zap for each new job that matches your filters | Feed: each job once per 30 days |
| Search | **Find Jobs** | A filtered search, up to 100 jobs | Search: every job returned |
| Search | **Find Job by ID** | One listing | Free |
| Search | **Find Company** | A company name or domain to company ids | Free |
| Search | **Geocode Location** | A place name to coordinates | \$0.001 per lookup |

For API keys and pricing, see the [connectors overview](https://jobo.world/docs/connectors/overview.md).

***

## Connect

Add the Jobo app to a Zap and paste a key from **Developers → API Keys** in the [dashboard](https://enterprise.jobo.world/api-keys?src=docs). The connection test never uses credits, and a mistyped key is rejected before any request.

A [sandbox key](https://jobo.world/docs/sandbox.md) connects and serves Find Jobs and Find Job by ID. New Job, Find Company, Geocode Location, and the dropdowns need a live key.

***

## New Job

Set at least one of Location, Sources, Companies, Industries, Job Categories, Job Subcategories, or Occupations; the trigger won't run without one. You can narrow further by Work Model, Employment Type, Experience Level, Languages, and Company Categories.

The trigger has no keyword, skills, or salary filter, because the feed it reads has none. Match on Job Categories or Occupations instead, or add a Filter step after the trigger. A job the Filter step drops was still delivered, and billed once.

Companies and Location each have a lookup field above them. Type two or more letters there, then open the dropdown.

### How it polls, and what it costs

A Zapier polling trigger keeps no watermark: each poll asks for a recent window and Zapier drops the jobs it has already seen. Search would bill those repeats on every poll, so the trigger reads the [feed](https://jobo.world/docs/api-reference/feed/stream-the-job-feed.md) instead, which bills a job only the first time you receive it in 30 days. The bill follows the number of new matching jobs, not how often Zapier polls.

| What happens | Billed |
| - | - |
| A new matching job is delivered | Once |
| The same job is read again on a later poll | No |
| The first read when the Zap is turned on | Yes; these jobs start no runs |
| Testing the step in the editor | Yes, for up to 5 jobs |
| An empty poll, a failed request, or a rate-limited request | No |

Limits to know:

* **Wallet cover.** Without a Job Search plan, each poll needs a balance that covers a full batch of 100 jobs (\$0.30), even when it delivers nothing new. A lower balance fails the poll with `402`.
* **Gaps.** Each poll looks back 6 hours. If the Zap is off for longer, jobs indexed in the gap aren't delivered. Find Jobs with **Discovered After** reads them.
* **Volume.** If more than 500 jobs match in one window, the trigger fails with a message instead of returning part of them. Narrow the filters, or use an outbound feed under **Data Platform → Outbound Feed** in the dashboard.

***

## Find Jobs

Every filter of [`POST /api/jobs/search`](https://jobo.world/docs/api-reference/jobs/search-jobs), plus **Maximum Jobs** (1 to 100, default 10). The search refuses to run with no filter set, because that would return, and bill, the first page of the whole index.

***

## Output

Every trigger and search returns flat records with snake\_case keys and an `id`. A job's first location is spread into `location`, `city`, `region`, `country`, `latitude`, and `longitude`, with every location in `all_locations`. A missing value is `null`; the key is always present.

***

> [card] [Related: n8n node](https://jobo.world/docs/connectors/n8n.md)
>
> The n8n trigger persists a watermark, so it can also filter on keywords and skills.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.