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.
• Output: Returns detailed geographical information for each zip code in a structured JSON format.

---

Usage

Input Schema

The actor accepts the following input:

{
  "zips": ["90210", "10001", "30301"]
}

Parameters:

• zips (required): An array of zip codes to retrieve data for.

---

Output Schema

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

[
  {
    "zip": "90210",
    "state": "CA",
    "city": "Beverly Hills",
    "counties": "Los Angeles",
    "centroid": {
      "lon": -118.414739,
      "lat": 34.101005
    }
  },
  {
    "zip": "10001",
    "state": "NY",
    "city": "New York",
    "counties": "New York",
    "centroid": {
      "lon": -73.996985,
      "lat": 40.75011
    }
  }
]

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.