Zip Code Geo Data Scraper

This Apify actor retrieves geographical data for a list of zip codes. For each zip code, it provides the state, city, county (or counties), and geographical centroid (latitude and longitude).

Features

• Input: Accepts an array of zip codes and an optional proxy configuration.
• Output: Returns detailed geographical information for each zip code in a structured JSON format.

---

Usage

Input Schema

The actor accepts the following input:

1{
2  "zips": ["90210", "10001", "30301"],
3  "proxy": {
4    "useApifyProxy": true,
5    "apifyProxyGroups": ["SHARED"]
6  }
7}

Parameters:

• zips (required): An array of zip codes to retrieve data for.
• proxy (optional): A residential proxy is highly recommended to avoid IP bans or CAPTCHAs during scraping.

---

Output Schema

The output is an array of objects, where each object represents geographical data for a zip code:

1[
2  {
3    "zip": "90210",
4    "state": "CA",
5    "city": "Beverly Hills",
6    "counties": "Los Angeles",
7    "centroid": {
8      "lon": -118.414739,
9      "lat": 34.101005
10    }
11  },
12  {
13    "zip": "10001",
14    "state": "NY",
15    "city": "New York",
16    "counties": "New York",
17    "centroid": {
18      "lon": -73.996985,
19      "lat": 40.75011
20    }
21  }
22]

Output Fields:

• zip: The queried zip code.
• state: The state where the zip code is located.
• city: The primary city for the zip code.
• counties: The county (or counties) for the zip code.
• centroid: An object containing the latitude (lat) and longitude (lon) of the geographical center of the zip code.

---

How to Run

1. Deploy the Actor: Deploy this actor to your Apify account.
2. Run the Actor: Provide the input zip codes and optional proxy settings.
3. Retrieve Results: Download the output JSON file or access the dataset in your Apify account.

---

Example Use Cases

• Data Enrichment: Use this actor to enrich customer data with geographical information.
• Mapping Applications: Fetch coordinates for mapping and location-based tools.
• Regional Analysis: Identify states, cities, and counties for zip codes in specific regions.

---

Limitations

• The accuracy of data depends on the source used for zip code lookups.
• Ensure proper proxy configuration to avoid IP-based rate limits.

---

Support

If you encounter any issues or have questions, feel free to open an issue.