{ "openapi": "3.0.1", "info": { "title": "Maricopa County (Phoenix) Restaurant Inspections Scraper", "description": "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.", "version": "0.1", "x-build-id": "rgX3hKzpwR6vihipQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groundplanes~maricopa-restaurant-inspections/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groundplanes-maricopa-restaurant-inspections", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/groundplanes~maricopa-restaurant-inspections/runs": { "post": { "operationId": "runs-sync-groundplanes-maricopa-restaurant-inspections", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/groundplanes~maricopa-restaurant-inspections/run-sync": { "post": { "operationId": "run-sync-groundplanes-maricopa-restaurant-inspections", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "zipCodes": { "title": "ZIP codes", "type": "array", "description": "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).", "items": { "type": "string" } }, "businessNames": { "title": "Business names", "type": "array", "description": "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.", "items": { "type": "string" } }, "city": { "title": "City (optional, with business names)", "type": "string", "description": "Upper-case city, e.g. TEMPE, PHOENIX, SCOTTSDALE. Applied to business-name searches." }, "permitTypeContains": { "title": "Permit type contains", "type": "string", "description": "Keep permits whose type contains this text, e.g. 'Eating & Drinking'. Leave empty for all." }, "includeInspections": { "title": "Include inspection history", "type": "boolean", "description": "Fetch each permit's inspection list (one extra request per permit). Required for grades and the onlyGrades filter.", "default": true }, "maxInspectionsPerPermit": { "title": "Max inspections per permit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Max inspections per permit.", "default": 10 }, "onlyGrades": { "title": "Only latest grades", "type": "array", "description": "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.", "items": { "type": "string" } }, "maxPermits": { "title": "Max permits", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Max permits.", "default": 100 }, "requestDelaySecs": { "title": "Delay between requests (seconds)", "minimum": 0.5, "type": "number", "description": "Politeness delay. Keep at 1s or more to be gentle with the county server.", "default": 1 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }