# Moving — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Compare cities by demographics and schools, search moving companies, and read moving guides to plan your relocation. Get detailed profiles on neighborhoods, company ratings, and expert articles to make informed decisions about your move.

**Category:** Maps & Geospatial | **Website:** [moving.com/](https://moving.com/) | **Docs:** [parse.bot/marketplace/50f8a6a5-3085-42c2-95ea-e0ceba01fef8/moving-com-api](https://parse.bot/marketplace/50f8a6a5-3085-42c2-95ea-e0ceba01fef8/moving-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-moving-com-api-50f8a6a5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### compare_cities

Compare demographics, income, ethnicity, and residential data between two zip codes. Returns arrays of comparison metrics, each carrying the metric name and the corresponding values for city1 and city2.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip1` | string | Yes | First 5-digit US zip code (e.g. 10001) |
| `zip2` | string | Yes | Second 5-digit US zip code (e.g. 60601) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moving-com-api-50f8a6a5/compare_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zip1":"<string>","zip2":"<string>"}'
```

### get_city_profile

Fetch city statistics by zip code. Returns demographics, income and jobs, ethnicity, and residential data as open maps of metric names to local/national value pairs. Each section groups related Census-derived indicators; the metric key set varies by data availability for the zip code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | Yes | 5-digit US zip code (e.g. 10001) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moving-com-api-50f8a6a5/get_city_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zip_code":"<string>"}'
```

### get_moving_articles

Retrieve moving tips and advice articles. Supports pagination and optional category filtering. Each article includes a title and full URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Article category slug in hyphenated format (e.g. moving-tips, saving-money, city-guides) |
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moving-com-api-50f8a6a5/get_moving_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_moving_company_detail

Fetch the full profile of a moving company by slug. Returns address, phone, website, services offered, DOT/MC registration numbers, and BBB rating. Slugs come from search_moving_companies results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Company slug from search_moving_companies results (e.g. upack-moving-582) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moving-com-api-50f8a6a5/get_moving_company_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_school_reports

List schools in a given zip code. Each school record includes name, address, type (public/private), student count, and rating. The list may be empty for zip codes with no registered schools.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zip_code` | string | Yes | 5-digit US zip code (e.g. 10001) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moving-com-api-50f8a6a5/get_school_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zip_code":"<string>"}'
```

### search_moving_companies

Browse the moving company directory. Returns a paginated list of companies sorted by BBB rating. Each page contains up to 15 company summaries with name and slug; use the slug with get_moving_company_detail for full profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-moving-com-api-50f8a6a5/search_moving_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```