{
  "info": {
    "name": "ISPData.io ISP Data API",
    "description": "ISP availability data for the entire United States. Over 115 million US broadband serviceable locations covering all 50 states, DC, and 5 US territories. Includes speed tests, complaints, broadband funding, demographics, cell towers, and more.\n\nGet your API key at https://ispdata.io/developer",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_exporter_id": "ispdata-io"
  },
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "X-API-Key",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{ISPDATA_API_KEY}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.ispdata.io/v1",
      "type": "string"
    },
    {
      "key": "ISPDATA_API_KEY",
      "value": "isp_your_api_key_here",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Broadband",
      "description": "Broadband provider lookup and coverage endpoints",
      "item": [
        {
          "name": "Address Lookup",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/broadband/lookup?lat=40.7128&lng=-74.006",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "broadband",
                "lookup"
              ],
              "query": [
                {
                  "key": "lat",
                  "value": "40.7128",
                  "description": "Latitude (-90 to 90)"
                },
                {
                  "key": "lng",
                  "value": "-74.006",
                  "description": "Longitude (-180 to 180)"
                },
                {
                  "key": "resolution",
                  "value": "8",
                  "description": "H3 resolution (7-9, default: 8)",
                  "disabled": true
                }
              ]
            },
            "description": "Look up broadband providers available at a specific geographic location. Uses H3 geospatial indexing with neighbor search for comprehensive coverage matching.\n\n**Available on all plans.**"
          },
          "response": [
            {
              "name": "NYC Lookup",
              "status": "OK",
              "code": 200,
              "body": "{\n \"status\": \"success\",\n \"data\": {\n  \"query\": {\n   \"lat\": 40.7128,\n   \"lng\": -74.006,\n   \"h3_cell\": \"882a100d25fffff\",\n   \"h3_resolution\": 8\n  },\n  \"provider_count\": 12,\n  \"providers\": [\n   { \"name\": \"Verizon\", \"coverage_cells\": 7, \"state_fips\": \"36\" },\n   { \"name\": \"Spectrum\", \"coverage_cells\": 5, \"state_fips\": \"36\" },\n   { \"name\": \"T-Mobile\", \"coverage_cells\": 7, \"state_fips\": \"36\" }\n  ]\n },\n \"meta\": {\n  \"response_time_ms\": 23,\n  \"data_source\": \"ISPData.io Verified Database\",\n  \"data_vintage\": \"2025-06-30\"\n }\n}"
            }
          ]
        },
        {
          "name": "Bulk Lookup",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n \"locations\": [\n  { \"lat\": 40.7128, \"lng\": -74.006, \"id\": \"nyc-office\" },\n  { \"lat\": 34.0522, \"lng\": -118.2437, \"id\": \"la-branch\" },\n  { \"lat\": 41.8781, \"lng\": -87.6298, \"id\": \"chicago-hq\" }\n ]\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/broadband/bulk-lookup",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "broadband",
                "bulk-lookup"
              ]
            },
            "description": "Look up broadband providers for multiple locations in a single request.\n\nMax locations per request by plan:\n- Starter: 25\n- Pro: 50\n- Enterprise: 100\n\n**Requires Starter plan or higher.**"
          },
          "response": [
            {
              "name": "Multi-city Lookup",
              "status": "OK",
              "code": 200,
              "body": "{\n \"status\": \"success\",\n \"data\": {\n  \"location_count\": 3,\n  \"results\": [\n   {\n    \"id\": \"nyc-office\",\n    \"lat\": 40.7128,\n    \"lng\": -74.006,\n    \"h3_cell\": \"882a100d25fffff\",\n    \"provider_count\": 12,\n    \"providers\": [\n     { \"name\": \"Verizon\" },\n     { \"name\": \"Spectrum\" }\n    ]\n   },\n   {\n    \"id\": \"la-branch\",\n    \"lat\": 34.0522,\n    \"lng\": -118.2437,\n    \"h3_cell\": \"8829a1072bfffff\",\n    \"provider_count\": 8,\n    \"providers\": [\n     { \"name\": \"AT&T\" },\n     { \"name\": \"Spectrum\" }\n    ]\n   }\n  ]\n },\n \"meta\": {\n  \"response_time_ms\": 67,\n  \"data_source\": \"ISPData.io Verified Database\",\n  \"data_vintage\": \"2025-06-30\"\n }\n}"
            }
          ]
        },
        {
          "name": "Coverage Analysis",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/broadband/coverage?state_fips=36",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "broadband",
                "coverage"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code (e.g., '36' for New York)"
                },
                {
                  "key": "provider",
                  "value": "Verizon",
                  "description": "Provider name filter",
                  "disabled": true
                }
              ]
            },
            "description": "Get coverage statistics by state and/or provider. Returns the number of unique H3 cells covered.\n\n**Requires Pro plan or higher.**"
          },
          "response": []
        },
        {
          "name": "Provider List",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/broadband/providers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "broadband",
                "providers"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "06",
                  "description": "Filter by state FIPS code",
                  "disabled": true
                }
              ]
            },
            "description": "List all unique broadband providers in the database, optionally filtered by state. Results sorted by coverage area.\n\n**Available on all plans.**"
          },
          "response": []
        },
        {
          "name": "Provider List by State",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/broadband/providers?state_fips=06",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "broadband",
                "providers"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "06",
                  "description": "California FIPS code"
                }
              ]
            },
            "description": "List providers filtered by state (California example).\n\n**Available on all plans.**"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Speed & Performance",
      "description": "Speed test data and provider performance metrics",
      "item": [
        {
          "name": "Speed Test by Location",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/speedtest/location?lat=40.7128&lng=-74.006",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "speedtest",
                "location"
              ],
              "query": [
                {
                  "key": "lat",
                  "value": "40.7128",
                  "description": "Latitude"
                },
                {
                  "key": "lng",
                  "value": "-74.006",
                  "description": "Longitude"
                },
                {
                  "key": "period",
                  "value": "30d",
                  "description": "Time period: 7d, 30d, 90d",
                  "disabled": true
                }
              ]
            },
            "description": "Real-world speed test results aggregated by location. Returns download/upload, latency, jitter, packet loss with percentile breakdowns.\n\n**Available on all plans.**"
          },
          "response": []
        },
        {
          "name": "Provider Performance",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/performance/provider",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "performance",
                "provider"
              ],
              "query": [
                {
                  "key": "provider",
                  "value": "Verizon",
                  "description": "Provider name filter",
                  "disabled": true
                },
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code",
                  "disabled": true
                }
              ]
            },
            "description": "Network performance metrics by ISP. Advertised vs measured speeds, latency, reliability, speed label compliance.\n\n**Available on all plans.**"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Consumer Data",
      "description": "consumer complaints and consumer satisfaction data",
      "item": [
        {
          "name": "Consumer Complaints",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/complaints/provider",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "complaints",
                "provider"
              ],
              "query": [
                {
                  "key": "provider",
                  "value": "Spectrum",
                  "description": "Provider name filter",
                  "disabled": true
                },
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code",
                  "disabled": true
                }
              ]
            },
            "description": "Consumer complaint data by provider. Categories, trends, satisfaction scores, resolution metrics.\n\n**Requires Starter plan or higher.**"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Infrastructure",
      "description": "Broadband funding, cell towers, and E-Rate data",
      "item": [
        {
          "name": "Broadband Funding",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/funding/area",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "funding",
                "area"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code",
                  "disabled": true
                },
                {
                  "key": "program",
                  "value": "BEAD",
                  "description": "Program: BEAD, RDOF, CAF-II, ACP, ReConnect, E-Rate",
                  "disabled": true
                }
              ]
            },
            "description": "Federal broadband funding data (BEAD, RDOF, CAF-II, ACP, ReConnect, E-Rate).\n\n**Requires Starter plan or higher.**"
          },
          "response": []
        },
        {
          "name": "Cell Tower Search",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/towers/search?lat=40.7128&lng=-74.006",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "towers",
                "search"
              ],
              "query": [
                {
                  "key": "lat",
                  "value": "40.7128",
                  "description": "Latitude"
                },
                {
                  "key": "lng",
                  "value": "-74.006",
                  "description": "Longitude"
                },
                {
                  "key": "radius_km",
                  "value": "5",
                  "description": "Search radius in km",
                  "disabled": true
                }
              ]
            },
            "description": "Search cell towers and antenna infrastructure by location. proprietary tower database.\n\n**Available on all plans.**"
          },
          "response": []
        },
        {
          "name": "E-Rate Entities",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/erate/entities?state_fips=36",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "erate",
                "entities"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code"
                },
                {
                  "key": "entity_type",
                  "value": "school",
                  "description": "school or library",
                  "disabled": true
                },
                {
                  "key": "zip",
                  "value": "10001",
                  "description": "ZIP code filter",
                  "disabled": true
                }
              ]
            },
            "description": "E-Rate funded school and library ISP data.\n\n**Requires Pro plan or higher.**"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Demographics & Market",
      "description": "Internet access demographics, market analysis, and digital divide data",
      "item": [
        {
          "name": "Internet Access Demographics",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/demographics/internet-access",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "demographics",
                "internet-access"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code",
                  "disabled": true
                },
                {
                  "key": "county_fips",
                  "value": "36071",
                  "description": "5-digit county FIPS",
                  "disabled": true
                }
              ]
            },
            "description": "Internet adoption and digital divide metrics by geographic area.\n\n**Requires Pro plan or higher.**"
          },
          "response": []
        },
        {
          "name": "Market Analysis",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/market/analysis",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "market",
                "analysis"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code",
                  "disabled": true
                },
                {
                  "key": "county_fips",
                  "value": "36071",
                  "description": "5-digit county FIPS",
                  "disabled": true
                }
              ]
            },
            "description": "Broadband market competition data: HHI index, technology breakdown, pricing, top providers.\n\n**Requires Pro plan or higher.**"
          },
          "response": []
        },
        {
          "name": "Internet Adoption & Digital Divide",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/adoption/barriers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "adoption",
                "barriers"
              ],
              "query": [
                {
                  "key": "state_fips",
                  "value": "36",
                  "description": "2-digit FIPS code",
                  "disabled": true
                },
                {
                  "key": "demographic",
                  "value": "income",
                  "description": "Demographic: income, age, education, geography",
                  "disabled": true
                }
              ]
            },
            "description": "Internet adoption barriers and digital divide analysis.\n\n**Requires Pro plan or higher.**"
          },
          "response": []
        }
      ]
    },
    {
      "name": "System",
      "description": "System health and status endpoints",
      "item": [
        {
          "name": "API Status",
          "request": {
            "auth": {
              "type": "noauth"
            },
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/status",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "status"
              ]
            },
            "description": "Check API health, database status, and data statistics.\n\n**No authentication required.**"
          },
          "response": [
            {
              "name": "Healthy Status",
              "status": "OK",
              "code": 200,
              "body": "{\n \"status\": \"operational\",\n \"version\": \"1.0.0\",\n \"database\": {\n  \"status\": \"healthy\",\n  \"total_records\": 115800000,\n  \"states_covered\": 56\n },\n \"data_source\": \"ISPData.io Verified Database\",\n \"data_vintage\": \"2025-06-30\",\n \"documentation\": \"/developer/docs\"\n}"
            }
          ]
        }
      ]
    }
  ]
}