> ## 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.

# Google Sheets add-on

> Import a filtered slice of Jobo's job index into a new Google Sheet, for market research, comp benchmarking, or a hiring pipeline.

**Jobo for Sheets** writes a filtered slice of Jobo's job index into a new sheet — one row per job, with company, location, work model, seniority, salary range, source, and apply URL already in columns. It's a one-shot import, not a sync: each run creates a fresh sheet and leaves the rest of your workbook untouched.

<Info>
  The Workspace Marketplace listing is pending review. Until it's live, install directly using the steps below — check back on this page, or watch the [source repository](https://github.com/JoboAI/jobo-sheets), for when the Marketplace listing goes live.
</Info>

This page assumes you've read the shared [Authentication](/docs/connectors/overview#authentication) and [Cost model](/docs/connectors/overview#cost-model) sections on the [connectors overview](/docs/connectors/overview) — it only covers what's specific to Sheets.

***

## Install

<Steps>
  <Step title="Install the add-on">
    Once listed, search for **Career Site Jobs for Sheets – Jobo** in the Google Workspace Marketplace and install it into your Google account. Until then, install it directly — see the [source repository](https://github.com/JoboAI/jobo-sheets) for the interim install steps.
  </Step>

  <Step title="Open the sidebar">
    In any spreadsheet, go to **Extensions → Career Site Jobs – Jobo → Import jobs**.
  </Step>

  <Step title="Add your API key">
    Paste your key from [enterprise.jobo.world/api-keys](https://enterprise.jobo.world/api-keys). It's validated before it's saved, so a typo fails immediately rather than on the first import.
  </Step>

  <Step title="Set filters and import">
    Choose how many jobs to pull, set your filters, and click **Import**. Results land in a new sheet, leaving anything already in the workbook untouched.
  </Step>
</Steps>

***

## Filters

Every filter lives in the sidebar. Fields with a suggestion picker are marked below — the rest are plain text, numbers, or checkboxes.

| Field                                               | Behaviour                                                                                                                                   |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Search**                                          | Free-text query, matched against title and (unless you turn it off under "More filters") the description.                                   |
| **Location**                                        | Start typing and pick from live suggestions resolved through Jobo's geocoder.                                                               |
| **Sources**                                         | Start typing to see matching ATS platforms suggested from the current index.                                                                |
| **Skills**                                          | Free-entry chips — type a skill and add it. Not suggested, since skills aren't a fixed list.                                                |
| **Industries**                                      | Start typing to see matching industries suggested from the current index.                                                                   |
| **Work model / Employment type / Experience level** | Checkbox groups: remote/hybrid/onsite; full-time/part-time/contract/internship/freelance/temporary; intern/entry/mid/senior/lead/executive. |
| **Minimum / maximum salary (USD)**                  | Only matches jobs whose employer published a range — a minority of listings.                                                                |
| **Posted after** (under "More filters")             | Only jobs posted on or after this date.                                                                                                     |
| **Search descriptions** (under "More filters")      | On by default; turn off to match only the title, which is faster and more precise.                                                          |
| **How many jobs**                                   | Caps the import at up to 1,000. This is also the number the balance precheck prices — see [Cost](#cost).                                    |

***

## Cost

You're billed per job imported. The balance is checked before the import runs and prices the full requested batch — so **"How many jobs"** is also your budget dial, not just a row count. Each import reports what it cost and what's left in the sidebar before you run another.

Salary filters are a common cause of a surprisingly small (or empty) import — see [Troubleshooting](#troubleshooting).

For a recurring dataset rather than a one-off pull, a Jobo Outbound Feed into a database is cheaper and doesn't need anyone to press a button — see your [dashboard](https://enterprise.jobo.world).

***

## Troubleshooting

| Problem                                               | Fix                                                                                                                                                                               |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Your Jobo credit balance is too low for this import" | The balance is checked before the import runs and prices the full requested batch. Import fewer jobs, or top up at [enterprise.jobo.world](https://enterprise.jobo.world).        |
| The import returned no jobs                           | Usually a salary filter — those only match jobs whose employer published a range, which is a minority of listings. Remove it and try again.                                       |
| A previous import was overwritten                     | It wasn't. Each import creates a new sheet, numbering the name if one already exists.                                                                                             |
| Large imports time out                                | Apps Script caps how long a single execution may run. Import in batches of a few hundred, or use the API directly for bulk work — see [Sync a database](/docs/guides/sync-a-database). |
| The add-on can't see other files in my Drive          | By design. It only requests access to the currently open spreadsheet, never the rest of your Drive.                                                                               |

***

<Card title="Related: n8n node" icon="diagram-project" href="/docs/connectors/n8n">
  For a recurring pull instead of a one-off spreadsheet export, the n8n node's Get Many (Feed) operation is the better fit.
</Card>
