[Integrations](https://spiral.ai/integrations) › [Muse](https://spiral.ai/integrations/muse) › [ZipRecruiter location suggestions](https://spiral.ai/integrations/muse/ziprecruiter-location-suggestions)

# How to Use ZipRecruiter location suggestions in Muse

Returns ZipRecruiter’s place suggestions for partial location text. Use it to choose the intended city and state before researching local jobs or salary benchmarks.

|  |  |
| --- | --- |
| Model | ZipRecruiter location suggestions |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with ZipRecruiter location suggestions in Muse

- Use ZipRecruiter location suggestions to look this up and give me the result as a table.
- Pull the latest numbers from ZipRecruiter location suggestions and tell me what changed since last week.
- Check ZipRecruiter location suggestions and summarize what you find in three bullet points.
- Pull the newest data from ZipRecruiter location suggestions and give me the result as a table.
- Check ZipRecruiter location suggestions every morning and tell me only when something changed.

## How to set up ZipRecruiter location suggestions in Muse

Pick the way that suits you. Each takes about two minutes.

### Use the Muse connector

1. **Create an API key**: Create one under API keys in the Spiral console.

2. **Send Muse this message**: Muse reads Spiral's skill and asks for an API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Muse the key**: Paste the key when Muse asks for it, never in the chat itself.

### Use the Spiral skill

1. **Send Muse this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run ZipRecruiter location suggestions**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "ziprecruiter-com/jobs/suggest_locations",
    "input": {
      "prefix": "<prefix>"
    }
  }'
```

Then paste one of the prompts above: Muse finds ZipRecruiter location suggestions on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse

## ZipRecruiter location suggestions tools and prices

- [ZipRecruiter US · Suggest locations](https://spiral.ai/tools/alexandria/ziprecruiter-com/jobs/suggest_locations) (Alexandria): $0.00873 per call.

## What can you do with ZipRecruiter location suggestions in Muse?

Compare advertised jobs and market pay for a role in a US city. ZipRecruiter’s title and place suggestions help define the comparison before you inspect employers and full postings.

### Prepare a local hiring brief

Resolve the role and city, collect local openings, examine selected employers, and read the full requirements. Put advertised pay beside the title’s salary benchmark to support a hiring discussion.

### Compare employers competing for the same role

Choose consistent title and city wording, find employers advertising the role, and inspect their openings and descriptions. Compare their advertised requirements and pay against the local benchmark.

### Research staffing in two candidate cities

Resolve each city and a common job title, compare salary benchmarks, and sample local postings. Examine relevant employers’ openings and full descriptions to explain differences in the roles being advertised.

### Build a career exploration brief

Turn a partial occupation name and place into a defined search, compare the salary benchmark with advertised roles, and shortlist employers. Read full postings to identify recurring responsibilities and requirements.

### Check title wording before a market comparison

Review recognized title suggestions before comparing the same occupation across cities. Use location suggestions to avoid mixing similarly named places, then retrieve the corresponding salary benchmarks.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse guides](https://spiral.ai/integrations/muse)

## ZipRecruiter location suggestions in other agents

- [Amp](https://spiral.ai/integrations/amp/ziprecruiter-location-suggestions)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/ziprecruiter-location-suggestions)
- [Claude](https://spiral.ai/integrations/claude-desktop/ziprecruiter-location-suggestions)
- [Claude Code](https://spiral.ai/integrations/claude-code/ziprecruiter-location-suggestions)
- [Cline](https://spiral.ai/integrations/cline/ziprecruiter-location-suggestions)
- [Codex](https://spiral.ai/integrations/codex/ziprecruiter-location-suggestions)
- [Cursor](https://spiral.ai/integrations/cursor/ziprecruiter-location-suggestions)
- [Devin](https://spiral.ai/integrations/devin/ziprecruiter-location-suggestions)
- [dots](https://spiral.ai/integrations/dots/ziprecruiter-location-suggestions)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/ziprecruiter-location-suggestions)
- [Gemini](https://spiral.ai/integrations/gemini/ziprecruiter-location-suggestions)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/ziprecruiter-location-suggestions)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/ziprecruiter-location-suggestions)
- [goose](https://spiral.ai/integrations/goose/ziprecruiter-location-suggestions)
- [Grok](https://spiral.ai/integrations/grok/ziprecruiter-location-suggestions)
- [Grok Build](https://spiral.ai/integrations/grok-build/ziprecruiter-location-suggestions)
- [Hermes](https://spiral.ai/integrations/hermes/ziprecruiter-location-suggestions)
- [Instinct](https://spiral.ai/integrations/instinct/ziprecruiter-location-suggestions)
- [Manus](https://spiral.ai/integrations/manus/ziprecruiter-location-suggestions)
- [Muse Code](https://spiral.ai/integrations/muse-code/ziprecruiter-location-suggestions)
- [n8n](https://spiral.ai/integrations/n8n/ziprecruiter-location-suggestions)
- [Notion](https://spiral.ai/integrations/notion/ziprecruiter-location-suggestions)
- [OpenClaw](https://spiral.ai/integrations/openclaw/ziprecruiter-location-suggestions)
- [opencode](https://spiral.ai/integrations/opencode/ziprecruiter-location-suggestions)
- [Perplexity](https://spiral.ai/integrations/perplexity/ziprecruiter-location-suggestions)
- [Raycast](https://spiral.ai/integrations/raycast/ziprecruiter-location-suggestions)
- [VS Code](https://spiral.ai/integrations/vscode/ziprecruiter-location-suggestions)
- [Windsurf](https://spiral.ai/integrations/windsurf/ziprecruiter-location-suggestions)
- [Zapier](https://spiral.ai/integrations/zapier/ziprecruiter-location-suggestions)

## More Muse guides

- [ZipRecruiter job title suggestions](https://spiral.ai/integrations/muse/ziprecruiter-job-title-suggestions)
- [ZipRecruiter salary benchmarks](https://spiral.ai/integrations/muse/ziprecruiter-salary-benchmarks)
- [ZipRecruiter job search](https://spiral.ai/integrations/muse/ziprecruiter-job-search)
- [iCIMS career portal filters](https://spiral.ai/integrations/muse/icims-career-portal-filters)
- [ZipRecruiter job details](https://spiral.ai/integrations/muse/ziprecruiter-job-details)
- [iCIMS job posting details](https://spiral.ai/integrations/muse/icims-job-posting-details)

## Questions about ZipRecruiter location suggestions in Muse

**Can Muse use ZipRecruiter location suggestions?**

Yes. Add Spiral to Muse as an MCP server, and Muse can find and run ZipRecruiter location suggestions like any built-in tool.

**How much does ZipRecruiter location suggestions cost in Muse?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Muse plan is separate.

**Do I need an Alexandria account to use ZipRecruiter location suggestions in Muse?**

You need no Alexandria account. Muse uses one Spiral API key for every tool, and Spiral runs ZipRecruiter location suggestions on its own Alexandria account.

**How long does it take to set up ZipRecruiter location suggestions in Muse?**

About two minutes: create an API key, then send Muse this message, then give Muse the key.

**Does Muse wait while ZipRecruiter location suggestions runs?**

ZipRecruiter location suggestions runs in the background. Muse starts the run, checks on it and gives you the json when it's ready.

**Which geographic market does this ZipRecruiter data cover?**

These endpoints cover ZipRecruiter’s US marketplace. Salary benchmarks cover a US city or the national market.

**How many jobs does a search page contain?**

Job search returns 20 cards per page. Use those cards to discover postings, then read full job details for the descriptions behind them.

**Does appearing in search mean a posting is recent?**

No. Alexandria documents that some ZipRecruiter search cards carry posting dates more than a year old.

**What does the salary benchmark measure?**

It describes yearly base pay for a title and market, with five reported points from the 10th through the 90th percentile. It is separate from a particular employer’s advertised offer.

**Why should I check location suggestions before choosing a city?**

The documented Austin example includes Austin Township in Oklahoma, Austin in Texas and Tennessee, and Austin suburbs. Match the city and state instead of accepting the first result.

