# Maricopa County (Phoenix) Restaurant Inspections Scraper (`groundplanes/maricopa-restaurant-inspections`) Actor

Scrape Maricopa County, AZ restaurant inspection grades (A–D) and violation history for Phoenix, Scottsdale, Tempe, Mesa, Chandler, Glendale and Gilbert. Search by ZIP or business name. No login. Export JSON, CSV or Excel, or use the API.

- **URL**: https://apify.com/groundplanes/maricopa-restaurant-inspections.md
- **Developed by:** [John](https://apify.com/groundplanes) (community)
- **Categories:** Lead generation, Business, Travel
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 permit with inspection histories

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

The **Maricopa County restaurant inspections scraper** gives you one row per restaurant permit (with its inspection history) for **Phoenix & Maricopa County, AZ**, straight from the public Restaurant Search endpoints of **Maricopa County Environmental Services** (envapp.maricopa.gov). No login or coding needed: run it in your browser, on a schedule, or through the Apify API, and export results as **JSON, CSV or Excel**.

Get food-establishment permits, letter grades and inspection history for **Maricopa County, Arizona**: Phoenix, Scottsdale, Tempe, Mesa, Chandler, Gilbert, Glendale, Peoria and more. Maricopa is the 4th-largest county in the US.

**Who uses it**

- Food-safety consultants and pest-control companies looking for restaurants with a recent B, C or D grade
- Restaurant suppliers, POS vendors and insurers building local lead lists
- Delivery apps, review sites and journalists who need grades in bulk

### How to scrape Maricopa County restaurant inspections

1. Click **Try for free** (or **Start**) on this page. A free Apify account is enough.
2. Leave the prefilled input to get a quick sample, or set the filters described below.
3. Set **maxPermits** to cap how many rows (and how much) a run returns.
4. Click **Start** and wait a few seconds to a minute.
5. Download the results as JSON, CSV or Excel, or connect them to Google Sheets, Zapier, Make or a webhook.

### Input

| Field | Meaning |
|---|---|
| `zipCodes` | Search by ZIP code (one search per ZIP) |
| `businessNames` + `city` | Search by part of the business name, optionally within one city (e.g. `TEMPE`) |
| `permitTypeContains` | For example `Eating & Drinking` |
| `includeInspections` | Adds the inspection history (one extra request per permit) |
| `onlyGrades` | Exact grade values, e.g. `["C","D"]`. Matches the latest *graded* inspection. Needs `includeInspections` (the run fails with a clear message otherwise). |
| `maxPermits`, `maxInspectionsPerPermit`, `requestDelaySecs` (≥0.5 s, default 1 s) | Limits and politeness delay |

If you give no ZIP codes and no business names, the run falls back to example ZIP 85281, capped at 20 permits. If you give a business name, no ZIP is added: a name-only search returns only name matches (and only in `city` if given). Like the county's own search page, a city search must also include a business name. For whole areas, search by ZIP.

### Output (one row per permit)

`permitId, businessName, permitType, address, zip, cuttingEdgeParticipant, inspectionCount, latestInspectionDate, latestGrade, latestGradeDate, latestLetterGrade, latestPriorityViolations, inspections[{date, purpose, grade, status, priorityViolations, reportUrl}], detailUrl`

#### Grade values

The county uses more than A–D. `latestGrade` is taken from the newest inspection **that has a grade**, so ungraded Food Advisory visits are skipped (`latestInspectionDate` is still the newest visit of any kind). Values you will see:

- `A`, `B`, `C`, `D`: letter grades
- other text values the county shows on some inspections (for example Cutting Edge labels)
- `R`: county code shown on some inspections
- `Not Participating`: the establishment isn't in the voluntary grading program
- `null`: no graded inspection on record

`latestLetterGrade` holds only a plain A–D letter, or null. `inspectionCount` is the total number of inspections listed on the permit page, before the `maxInspectionsPerPermit` trim.

### Data source & responsible use

The Actor reads the same public endpoints as the county's Restaurant Search page (envapp.maricopa.gov). It needs no login and reads at about one request per second. The data covers business permits and inspection outcomes only; it collects no personal data. Inspection records are public, and the county keeps reports for 3 years. Not affiliated with Maricopa County.

### Pricing (pay per event)

$3 per 1,000 permits ($0.003 each), plus Apify's minimal $0.00005 start fee. **Example:** the default 100 permits (ZIP 85281) cost about $0.30. If a run hits your max charge limit, it stops cleanly and reports how many rows it delivered.

### Sample output

```json
{
  "permitId": "FD-00021",
  "businessName": "Hackett House",
  "permitType": "Food Establishment - Eating & Drinking",
  "address": "95 W 4th ST TEMPE AZ 85281",
  "zip": "85281",
  "cuttingEdgeParticipant": false,
  "detailUrl": "https://envapp.maricopa.gov/Permit/PermitResults/FD-00021",
  "searchedBy": {
    "Zip": "85281"
  },
  "scrapedAt": "2026-10-12T17:53:29.560468Z",
  "inspectionCount": 6,
  "inspections": [
    {
      "date": "2026-05-01",
      "purpose": "Food Routine Inspection",
      "grade": "A",
      "status": "Completed",
      "priorityViolations": 0,
      "reportUrl": "https://envapp.maricopa.gov/Inspection/FD-00021/INSP-209844-2025"
    },
    {
      "date": "2025-10-22",
      "purpose": "Food Routine Inspection",
      "grade": "A",
      "status": "Completed",
      "priorityViolations": 0,
      "reportUrl": "https://envapp.maricopa.gov/Inspection/FD-00021/INSP-084373-2025"
    }
  ],
  "latestInspectionDate": "2026-05-01",
  "latestGrade": "A",
  "latestGradeDate": "2026-05-01",
  "latestLetterGrade": "A",
  "latestPriorityViolations": 0
}
```

### Source, license & data caveats

Data is provided as published on the county's public Restaurant Search (envapp.maricopa.gov). The county publishes no open-data license for this search. Inspection results are public records under Arizona public records law (A.R.S. § 39-121), and use of the site is subject to Maricopa County's website terms of use. Check the county's terms before commercial reuse. Grades reflect the county's voluntary Cutting Edge program.

### FAQ

#### How much does it cost to scrape Maricopa County restaurant inspections?

You pay $0.003 per result ($3 per 1,000) plus a $0.00005 start fee, and nothing else. Apify's free plan includes $5 of monthly credit, which covers about 1,600 results. See **Pricing** above for a worked example.

#### Is it legal to scrape Maricopa County restaurant inspections?

This Actor reads public records from the public Restaurant Search endpoints of **Maricopa County Environmental Services** (envapp.maricopa.gov), using only public endpoints (no login, no CAPTCHA bypass, no private accounts). See the source/license section above for the dataset's terms. You are responsible for how you use the data; this is not legal advice.

#### How fresh is the data?

Each run reads the source live, so you get whatever the agency has published at that moment. How often the agency updates, and any known lag, is described in the data caveats/notes section above.

#### Can I use it via API, on a schedule, or with Google Sheets?

Yes. Every Apify Actor has a REST API and client libraries for Python and JavaScript. You can schedule daily or weekly runs, and send results to Google Sheets, Slack, Zapier, Make, n8n, webhooks, or an AI agent via the Apify MCP server.

#### I need another city, county or field. Can you add it?

Open an issue on the **Issues** tab with the city or data source you need. We build new public-records scrapers regularly.

### More public-records scrapers by Groundplanes

Same clean output, pay-per-result pricing and official public data sources:

#### Restaurant & food inspections

- [Las Vegas Restaurant Inspections & Grades Scraper (SNHD)](https://apify.com/groundplanes/las-vegas-restaurant-inspections)
- [Pittsburgh Restaurant Inspections Scraper (Allegheny County)](https://apify.com/groundplanes/allegheny-restaurant-inspections)
- [Delaware Restaurant Inspections Scraper — Statewide Violations](https://apify.com/groundplanes/delaware-restaurant-inspections)
- [Boulder CO Restaurant Inspections Scraper — 2013–2026 Snapshot](https://apify.com/groundplanes/boulder-county-restaurant-inspections)
- [Montgomery County MD Restaurant & Food Inspections Scraper](https://apify.com/groundplanes/montgomery-md-food-inspections)
- [NY State Restaurant Inspections Scraper — NYSDOH, Non-NYC](https://apify.com/groundplanes/ny-state-food-service-inspections)

#### Code violations & distressed property leads

- [Pittsburgh Code Violations Scraper — Distressed Property Leads](https://apify.com/groundplanes/pittsburgh-code-violations)
- [Orlando FL Code Enforcement Scraper — Code Violation Leads](https://apify.com/groundplanes/orlando-code-enforcement-cases)
- [New Orleans Code Violations Scraper — Code Enforcement Leads](https://apify.com/groundplanes/nola-code-enforcement-violations)

#### Business licenses & new business leads

- [Delaware Business Licenses Scraper — New Business Leads](https://apify.com/groundplanes/delaware-business-licenses)
- [Norfolk VA Business Licenses Scraper — New Business Leads](https://apify.com/groundplanes/norfolk-va-business-licenses)
- [Berkeley CA Business Licenses Scraper — Local B2B Leads](https://apify.com/groundplanes/berkeley-ca-business-licenses)
- [New Orleans Business Licenses Scraper — New Business Leads](https://apify.com/groundplanes/nola-occupational-business-licenses)

# Actor input Schema

## `zipCodes` (type: `array`):

Maricopa County ZIP codes to search, e.g. 85281. Each ZIP is one search. Leave empty when searching by business name only. Provide ZIP codes or business names (or both).

## `businessNames` (type: `array`):

Business name searches (partial match), e.g. 'taco'. Combine with City to narrow. The county site requires a ZIP, business name or street with every city search.

## `city` (type: `string`):

Upper-case city, e.g. TEMPE, PHOENIX, SCOTTSDALE. Applied to business-name searches.

## `permitTypeContains` (type: `string`):

Keep permits whose type contains this text, e.g. 'Eating & Drinking'. Leave empty for all.

## `includeInspections` (type: `boolean`):

Fetch each permit's inspection list (one extra request per permit). Required for grades and the onlyGrades filter.

## `maxInspectionsPerPermit` (type: `integer`):

Max inspections per permit.

## `onlyGrades` (type: `array`):

Keep permits whose latest graded inspection has one of these grades (case-insensitive, exact). Values used by the county: A, B, C, D, Cutting Edge A+, R, Not Participating. Ungraded Advisory visits are skipped. Needs 'Include inspection history'. Example: C, D. Permits marked Not Participating are only kept if you list 'Not Participating' too.

## `maxPermits` (type: `integer`):

Max permits.

## `requestDelaySecs` (type: `number`):

Politeness delay. Keep at 1s or more to be gentle with the county server.

## Actor input object example

```json
{
  "zipCodes": [
    "85281"
  ],
  "includeInspections": true,
  "maxInspectionsPerPermit": 10,
  "maxPermits": 100,
  "requestDelaySecs": 1
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "zipCodes": [
        "85281"
    ],
    "maxPermits": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("groundplanes/maricopa-restaurant-inspections").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "zipCodes": ["85281"],
    "maxPermits": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("groundplanes/maricopa-restaurant-inspections").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "zipCodes": [
    "85281"
  ],
  "maxPermits": 100
}' |
apify call groundplanes/maricopa-restaurant-inspections --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,groundplanes/maricopa-restaurant-inspections"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Zb7pZGP9YTYtIMfAO/builds/B8jafP9ghhkmhsI6X/openapi.json