# Kenya County Connectivity Data (`wafspaul/kenya-county-connectivity`) Actor Returns internet and electricity access data for all 47 counties in Kenya. Built from KNBS, OpenCelliD, Ookla, and KPLC datasets. Useful for NGOs, telcos, county governments, and researchers. - **URL**: https://apify.com/wafspaul/kenya-county-connectivity.md - **Developed by:** [paul wamocha](https://apify.com/wafspaul) (community) - **Categories:** Other, Integrations - **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Kenya County Connectivity Data Returns structured internet and electricity access data for all 47 counties in Kenya. Filter by county, region, or connectivity tier. Built from the Kenya Connectivity Map project — a data resource for investors, NGOs, telcos, and county governments. **Live map:** [kenya-connectivity-map.vercel.app](https://kenya-connectivity-map.vercel.app) --- ### What you get Each county record includes: **Internet data** (Sources: KNBS 2022 KDHS + 2023-24 KHS, OpenCelliD 2024, Ookla Q4 2024) - Household internet usage % (2022) - Individual internet usage % (2024) - Total mobile towers - Tower density per 100km² - 4G tower share % - Download / upload speed (Mbps) - Latency (ms) - Composite connectivity score /100 - Connectivity tier: Critical / Low / Medium / High **Electricity data** (Source: KIHBS 2015/16 via KPLC) - Electrification rate % --- ### Input | Parameter | Type | Default | Description | |---|---|---|---| | `county` | string | `all` | County name (e.g. `Nairobi`) or `all` for all 47 counties | | `region` | string | — | Filter by region: `Central`, `Coast`, `Eastern`, `Nairobi`, `North Eastern`, `Nyanza`, `Rift Valley`, `Western` | | `tier` | string | — | Filter by connectivity tier: `Critical`, `Low`, `Medium`, `High` | | `sortBy` | string | `county` | Sort by: `county`, `composite_score`, `internet_usage`, `electrification` | --- ### Example inputs **Get all counties sorted by score:** ```json { "county": "all", "sortBy": "composite_score" } ```` **Get a single county:** ```json { "county": "Mombasa" } ``` **Get all Critical-tier counties:** ```json { "tier": "Critical", "sortBy": "electrification" } ``` **Get all Rift Valley counties:** ```json { "region": "Rift Valley", "sortBy": "internet_usage" } ``` *** ### Example output ```json { "knbs_code": 47, "county": "Nairobi", "region": "Nairobi", "internet": { "household_usage_pct_2022": 39.6, "individual_usage_pct_2024": 64.7, "towers_total": 6689, "towers_per_100km2": 6689.8, "towers_4g_pct": 8.1, "download_mbps": 61.32, "upload_mbps": 19.06, "latency_ms": 71.8, "composite_score": 98.0, "connectivity_tier": "High" }, "electricity": { "electrification_pct": 91.3, "data_source": "KIHBS 2015/16" } } ``` *** ### Connectivity tiers | Tier | Composite Score | Description | |---|---|---| | **High** | 70–100 | Strong connectivity on both usage and infrastructure | | **Medium** | 45–69 | Moderate — urban secondary or peri-urban counties | | **Low** | 25–44 | Below national average — rural with some coverage | | **Critical** | 0–24 | Severely underserved — KOSAP/REREC intervention areas | *** ### Data notes - Internet speed data for Garissa, Wajir, Mandera, and Kitui may reflect Starlink bias — composite scores use adjusted weighting for these counties. - Electricity data is from KIHBS 2015/16, the most complete county-level survey available. More recent KPLC connection data exists for some counties but is not uniformly available. - Dataset last updated: March 2026. *** ### Use cases - **NGOs and DFIs:** Identify counties needing digital and energy infrastructure investment for programme targeting. - **Telcos:** Site selection and coverage gap analysis. - **County governments:** Baseline connectivity data for county development plans and grant applications. - **EdTech and FinTech:** Market sizing and product viability by county. - **Researchers:** Ready-to-use structured dataset for digital divide analysis. *** Built by **Paul Wamocha** | [Kenya Connectivity Map](https://kenya-connectivity-map.vercel.app) # Actor input Schema ## `county` (type: `string`): County name (e.g. 'Nairobi', 'Mombasa') or 'all' for all 47 counties. Case-insensitive. ## `region` (type: `string`): Filter by region: 'Central', 'Coast', 'Eastern', 'Nairobi', 'North Eastern', 'Nyanza', 'Rift Valley', 'Western'. Leave blank for all. ## `tier` (type: `string`): Filter by connectivity tier: 'Critical', 'Low', 'Medium', 'High'. Leave blank for all. ## `sortBy` (type: `string`): Sort the results by a field. ## Actor input object example ```json { "county": "all", "tier": "", "sortBy": "county" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("wafspaul/kenya-county-connectivity").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("wafspaul/kenya-county-connectivity").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call wafspaul/kenya-county-connectivity --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=wafspaul/kenya-county-connectivity", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kenya County Connectivity Data", "description": "Returns internet and electricity access data for all 47 counties in Kenya. Built from KNBS, OpenCelliD, Ookla, and KPLC datasets. Useful for NGOs, telcos, county governments, and researchers.", "version": "1.0", "x-build-id": "kK39se2fyLWzcB2Vf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wafspaul~kenya-county-connectivity/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wafspaul-kenya-county-connectivity", "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/wafspaul~kenya-county-connectivity/runs": { "post": { "operationId": "runs-sync-wafspaul-kenya-county-connectivity", "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/wafspaul~kenya-county-connectivity/run-sync": { "post": { "operationId": "run-sync-wafspaul-kenya-county-connectivity", "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": { "county": { "title": "County", "type": "string", "description": "County name (e.g. 'Nairobi', 'Mombasa') or 'all' for all 47 counties. Case-insensitive.", "default": "all" }, "region": { "title": "Region", "type": "string", "description": "Filter by region: 'Central', 'Coast', 'Eastern', 'Nairobi', 'North Eastern', 'Nyanza', 'Rift Valley', 'Western'. Leave blank for all." }, "tier": { "title": "Connectivity Tier", "enum": [ "", "Critical", "Low", "Medium", "High" ], "type": "string", "description": "Filter by connectivity tier: 'Critical', 'Low', 'Medium', 'High'. Leave blank for all.", "default": "" }, "sortBy": { "title": "Sort By", "enum": [ "county", "composite_score", "internet_usage", "electrification" ], "type": "string", "description": "Sort the results by a field.", "default": "county" } } }, "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 } } } } } } } } } } ```