Pricing

from $3.75 / 1,000 result items

Try for free

Go to Apify Store

NYC 311 Service Requests Scraper

Try for free

Scrapes NYC 311 service requests from the public data feed. Filter by complaint type, agency, borough, status, ZIP code, and date range, and get each request as a flat row.

Pricing

from $3.75 / 1,000 result items

Rating

0.0

(0)

Developer

ParseForge

Actor stats

Bookmarked

Total users

Monthly active users

8 hours ago

Last modified

Categories

Business

Other

Automation

You can access the NYC 311 Service Requests Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "LsaAWHzjQRpUeEFQe"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parseforge~nyc-311-service-requests-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parseforge-nyc-311-service-requests-scraper",
        "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/parseforge~nyc-311-service-requests-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parseforge-nyc-311-service-requests-scraper",
        "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/parseforge~nyc-311-service-requests-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parseforge-nyc-311-service-requests-scraper",
        "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": {
          "maxItems": {
            "title": "Maximum service requests",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of service requests to collect per run."
          },
          "complaintType": {
            "title": "Complaint Type",
            "type": "string",
            "description": "Filter records to a specific complaint type (e.g. Noise - Residential, HEAT/HOT WATER, Illegal Parking)."
          },
          "agency": {
            "title": "Agency",
            "enum": [
              "NYPD",
              "HPD",
              "DOT",
              "DSNY",
              "DEP",
              "DOB",
              "DOHMH",
              "DPR",
              "DCA",
              "TLC",
              "DHS",
              "ACS",
              "DOE",
              "DFTA",
              "EDC",
              "FDNY",
              "HRA",
              "OATH",
              "NYCEM"
            ],
            "type": "string",
            "description": "Filter by responding city agency code."
          },
          "borough": {
            "title": "Borough",
            "enum": [
              "MANHATTAN",
              "BROOKLYN",
              "QUEENS",
              "BRONX",
              "STATEN ISLAND"
            ],
            "type": "string",
            "description": "Restrict to a single borough."
          },
          "status": {
            "title": "Status",
            "enum": [
              "Open",
              "In Progress",
              "Closed",
              "Pending",
              "Assigned",
              "Started",
              "Email Sent",
              "Unspecified"
            ],
            "type": "string",
            "description": "Open, in-progress, or closed records."
          },
          "openedFrom": {
            "title": "Opened From (YYYY-MM-DD)",
            "type": "string",
            "description": "Only records opened on or after this date."
          },
          "openedTo": {
            "title": "Opened To (YYYY-MM-DD)",
            "type": "string",
            "description": "Only records opened on or before this date."
          },
          "zip": {
            "title": "ZIP code",
            "type": "string",
            "description": "Filter by incident ZIP code."
          },
          "sortOrder": {
            "title": "Sort Order",
            "enum": [
              "newest",
              "oldest"
            ],
            "type": "string",
            "description": "Order returned records by creation date."
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

NYC 311 Scraper - Service Requests & Open Data Export OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for NYC 311 Service Requests Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

NYC 311 Service Requests Scraper API in Python

NYC 311 Service Requests Scraper API in JavaScript

NYC 311 Service Requests Scraper API through CLI

NYC 311 Service Requests Scraper API

Chicago 311 Complaints & Service Requests

muhammadafzal/chicago-311-complaints-scraper

Extract live Chicago 311 service requests by date, type, status, ward, community area, ZIP code, or request number. Returns address, department, dates, coordinates, and City source links.

Muhammad Afzal

Chicago 311 Complaints Scraper

parseforge/chicago-311-complaints-scraper

Scrapes Chicago 311 service requests filtered by type and status. Returns each complaint as a flat row with creation date, status, and location. Export to CSV, JSON, Excel, or XML.

ParseForge

Open311 Service Request Extractor

datamule/open311-service-request-extractor

Point at any Open311 (GeoReport v2) city for one structured row per 311 service request: id, status, service, description, address, coordinates, media, agency, timestamps. Also pull the service-type catalog and the endpoint discovery — the open municipal-311 standard, anonymous read.

Datamule

Boston 311 Complaints Scraper

parseforge/boston-311-complaints-scraper

Scrapes Boston 311 service requests filtered by year, case status, and search query. Returns each complaint as a flat row with case ID, type, address, neighborhood, department, status, and dates.

ParseForge

NYC Open Data Dataset Search

scrupulous_waterbird_m4w/nyc-open-data

Search NYC Open Data and Socrata datasets including 311 requests, restaurant inspections, building permits, and the public catalog. Export normalized records with SoQL filters and pagination.

Mori

NYC Building Permits Scraper

parseforge/nyc-building-permits-scraper

Collects NYC building permits from the Department of Buildings public feeds. Each row returns job number, address, owner, filing date, and work description, filtered by borough, ZIP code, job type, or date range.

ParseForge

Open311 Issue Radar

opalescent_game/open311-issue-radar

Track potholes, graffiti, illegal dumping, noise complaints & 311 civic issues from 30+ US cities. Real-time data from Open311 & SeeClickFix APIs. Filter by keyword, status, radius & date range. Returns JSON with GPS coordinates, photos, votes & status tracking. RSS feed for automated alerts.

tyler

NYC Property Sales Scraper

parseforge/nyc-property-sales-scraper

Scrapes NYC property sales from the DOF Rolling Sales dataset and returns each sale as a flat row with price, address, borough, tax class, and building details. Filter by borough and export up to a million records.

ParseForge

NYC Restaurant Inspections Scraper

parseforge/nyc-restaurant-inspections-scraper

Scrapes NYC restaurant inspection records from the Department of Health. Returns each inspection as a flat row with grade, score, violations, and date. Filter by borough and letter grade.

ParseForge

NYC DOB Permits & Violations Scraper

crawlerbros/nyc-dob-permits-violations-scraper

Scrape NYC Department of Buildings (DOB) construction permits and code violations from the public NYC Open Data API. Filter by borough, address, BIN, block/lot, job/permit type, permit status, violation category, and date range.