# Global Population & Demographics Data ## Links - Product page URL: https://www.agentpmt.com/marketplace/population-demographics - Product markdown URL: https://www.agentpmt.com/marketplace/population-demographics?format=agent-md - Product JSON URL: https://www.agentpmt.com/marketplace/population-demographics?format=agent-json ## Overview - Product ID: 6980e0f571cad8f61bf5b1fb - Type: data - Unit type: request - Price: 1000 credits - Categories: Data Science, Data Processing, Academic & Scientific Research, Public Records & Government Data, Health & Fitness Data, Civic Data & Demographics - Generated at: 2026-06-25T04:24:07.057Z ### Page Description Access detailed population and demographic data for every country on earth. Look up total population counts, growth rates, age distributions, fertility trends, migration patterns, and urban-rural splits. Build age pyramids, calculate dependency ratios, and compare demographic profiles across countries and regions — all from a comprehensive global data set. ### Agent Description Query population totals, growth rates, age structure, fertility rates, migration data, and urban-rural splits for any country or region. Supports dependency ratio calculations, age pyramid breakdowns, and time-series trends across configurable periods. ## Details ### Details Access detailed population and demographic data for every country on earth. Look up total population counts, growth rates, age distributions, fertility trends, migration patterns, and urban-rural splits. Build age pyramids, calculate dependency ratios, and compare demographic profiles across countries and regions — all from a comprehensive global data set. ### Actions - `query_population_data` (10 credits): Query World Bank population and demographic indicators by country/region and demographic aspect. Returns data on population size, growth rates, age structure, fertility/mortality, urban-rural splits, migration, dependency ratios, and demographic transition analysis. ### Use Cases Look up a country's total population and growth rate, Compare age distributions across countries, Analyze fertility rate trends over time, Research migration patterns by country, Calculate dependency ratios from age structure, Compare urban vs rural population splits, Build demographic profiles for market research, Study population aging trends, Support academic demographic research, Track population projections and forecasts ### Workflows Using This Tool #### Country Data Snapshot Fetches population and demographics data for a specified country, analyzes key trends, and generates a chart visualization of the results. No credentials or user accounts required. - Page URL: https://www.agentpmt.com/agent-workflow-skills/country-data-snapshot - Markdown URL: https://www.agentpmt.com/agent-workflow-skills/country-data-snapshot?format=agent-md - Published: 2026-02-17T04:09:34.899Z ### Related Content No related content is currently linked to this product. ## Integration Details ### DynamicMCP - Setup page URL: https://www.agentpmt.com/dynamic-mcp - Claude setup guide: https://www.agentpmt.com/dynamic-mcp#platform=claude - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp#platform=chatgpt - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp#platform=cursor - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp#platform=windsurf Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally. ```bash npm install -g @agentpmt/mcp-router agentpmt-setup ``` ### REST API The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials. - Purchase endpoint: https://api.agentpmt.com/products/purchase - Authorization format: `Bearer ` ```bash curl -X POST "https://api.agentpmt.com/products/purchase" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \ -d '{ "product_id": "6980e0f571cad8f61bf5b1fb", "parameters": { "action": "query_population_data", "country_or_region": "example_country_or_region", "demographic_aspect": "all", "calculate_dependency_ratios": true, "include_urban_rural": false, "time_period": "latest" } }' ``` ### Autonomous Agents Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below. - Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents - Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md - Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress - AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls. - Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state. - Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche. #### Product Skill Package This product has a published Agent Skill package for product-specific operating instructions. - Skill slug: global-population-demographics-data - Version: 1.0.0 - Download SKILL.md: https://raw.githubusercontent.com/AgentPMT/agent-skills/main/skills/global-population-demographics-data/SKILL.md - Package source: https://github.com/AgentPMT/agent-skills/tree/main/skills/global-population-demographics-data - OpenClaw listing: https://clawhub.ai/agentpmt/global-population-demographics-data - OpenClaw install: `openclaw skills install global-population-demographics-data` - skills.sh install: `npx skills add AgentPMT/agent-skills --skill global-population-demographics-data` - Last published: 2026-06-24T05:49:57.871Z ### Schema #### Parameters - Schema type: actions ```json { "actions": { "query_population_data": { "description": "Query World Bank population and demographic indicators by country/region and demographic aspect. Returns data on population size, growth rates, age structure, fertility/mortality, urban-rural splits, migration, dependency ratios, and demographic transition analysis.", "properties": { "country_or_region": { "type": "string", "description": "Country name, ISO3 code (e.g., 'USA', 'JPN'), or region (e.g., 'East Asia')", "required": true }, "demographic_aspect": { "type": "string", "description": "Demographic category to query: 'population' (total, growth, density), 'growth' (birth/death rates, migration), 'age' (age groups, dependency ratios), 'fertility' (fertility/birth rates), 'migration' (net migration), 'all' (all indicators)", "required": false, "default": "all", "enum": [ "population", "growth", "age", "fertility", "migration", "all" ] }, "calculate_dependency_ratios": { "type": "boolean", "description": "Automatically calculate dependency ratios from age structure data when aspect is 'all' or 'age'", "required": false, "default": true }, "include_urban_rural": { "type": "boolean", "description": "Include urban vs rural population percentage breakdown", "required": false, "default": false }, "time_period": { "type": "string", "description": "Time period for data: 'latest', a year like '2022', a range like '2010:2023', or shorthand 'last5'/'last10'", "required": false, "default": "latest" } } } }, "properties": { "action": { "type": "string", "description": "Action to perform", "required": true, "enum": [ "get_instructions", "query_population_data" ] }, "country_or_region": { "type": "string", "description": "Country name, ISO code (e.g., 'USA', 'JPN'), or region (e.g., 'East Asia')", "required": false }, "demographic_aspect": { "type": "string", "description": "Demographic category: 'population', 'growth', 'age', 'fertility', 'migration', 'all'. Default: 'all'", "required": false, "enum": [ "population", "growth", "age", "fertility", "migration", "all" ] }, "calculate_dependency_ratios": { "type": "boolean", "description": "Automatically calculate dependency ratios from age structure data", "required": false, "default": true }, "include_urban_rural": { "type": "boolean", "description": "Include urban vs rural population breakdown", "required": false }, "time_period": { "type": "string", "description": "Time period: 'latest', 'YYYY' (e.g., '2022'), 'YYYY:YYYY' (range, e.g., '2010:2023')", "required": false, "default": "latest" } } } ``` ### Usage Instructions # Population & Demographics Data ## Overview Query World Bank population and demographic indicators for any country or region. Access data on population size, growth rates, age structure, fertility and mortality, urban/rural splits, migration, dependency ratios, and demographic transition analysis. All data sourced from the World Bank Data360 API (World Development Indicators). ## Actions ### query_population_data Query demographic indicators by country/region and demographic aspect. **Required Parameters:** | Parameter | Type | Description | |-----------|------|-------------| | `action` | string | Must be `"query_population_data"` | | `country_or_region` | string | Country name, ISO3 code, or region. Examples: `"United States"`, `"USA"`, `"JPN"`, `"Kenya"`, `"India"` | **Optional Parameters:** | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `demographic_aspect` | string | `"all"` | Category of indicators to return. One of: `"population"`, `"growth"`, `"age"`, `"fertility"`, `"migration"`, `"all"` | | `calculate_dependency_ratios` | boolean | `true` | Automatically calculate dependency ratios from age structure data when aspect is `"all"` or `"age"` | | `include_urban_rural` | boolean | `false` | Include urban vs rural population percentage breakdown | | `time_period` | string | `"latest"` | Time period for data. Accepts: `"latest"`, a single year like `"2022"`, a range like `"2010:2023"`, or shorthand `"last5"` / `"last10"` | **Demographic Aspects:** - **`population`** -- Total population, population growth rate (annual %), population density (people per sq. km) - **`growth`** -- Population growth rate, birth rate (per 1,000), death rate (per 1,000), net migration - **`age`** -- Age groups (0-14, 15-64, 65+ as % of total), age dependency ratio, youth dependency, elderly dependency - **`fertility`** -- Fertility rate (births per woman), birth rate (per 1,000) - **`migration`** -- Net migration (number of people) - **`all`** -- All available indicators combined #### Example: Basic country population data ```json { "action": "query_population_data", "country_or_region": "Japan" } ``` #### Example: Age structure with dependency ratios ```json { "action": "query_population_data", "country_or_region": "Germany", "demographic_aspect": "age", "calculate_dependency_ratios": true } ``` #### Example: Growth indicators for a specific year ```json { "action": "query_population_data", "country_or_region": "Nigeria", "demographic_aspect": "growth", "time_period": "2020" } ``` #### Example: Full profile with urban/rural breakdown ```json { "action": "query_population_data", "country_or_region": "Brazil", "demographic_aspect": "all", "include_urban_rural": true, "calculate_dependency_ratios": true, "time_period": "latest" } ``` #### Example: Historical fertility data over a range ```json { "action": "query_population_data", "country_or_region": "India", "demographic_aspect": "fertility", "time_period": "2000:2023" } ``` #### Example: Migration data using ISO3 code ```json { "action": "query_population_data", "country_or_region": "MEX", "demographic_aspect": "migration", "time_period": "last5" } ``` ## Workflows ### Demographic Profile Report 1. Call `query_population_data` with `demographic_aspect: "all"`, `include_urban_rural: true`, and `calculate_dependency_ratios: true` to get a full country profile. 2. The response includes indicators, dependency ratios, urban/rural split, demographic transition stage analysis, and age structure interpretation. ### Country Comparison 1. Call `query_population_data` for each country with the same `demographic_aspect` and `time_period`. 2. Compare the returned indicator values, dependency ratios, and transition stages side by side. ### Trend Analysis 1. Call `query_population_data` with a `time_period` range (e.g., `"2000:2023"`) and a specific `demographic_aspect`. 2. The response contains data points across the range for tracking changes over time. ### Aging Population Assessment 1. Call `query_population_data` with `demographic_aspect: "age"` and `calculate_dependency_ratios: true`. 2. Review the age structure interpretation (young, balanced, mature, aging), estimated median age range, and policy implications in the response. ## Notes - **Country input**: Accepts common country names (e.g., `"United States"`, `"South Korea"`), short forms (e.g., `"USA"`, `"UK"`), and ISO3 codes (e.g., `"GBR"`, `"JPN"`). If no country is provided, defaults to world (`"WLD"`). - **Supported countries**: Major economies, African nations (Kenya, Nigeria, South Africa, Ethiopia, etc.), Asian countries (Indonesia, Pakistan, Bangladesh, etc.), European countries (Netherlands, Poland, Sweden, etc.), Latin America (Argentina, Colombia, Chile, etc.), and Middle East (Saudi Arabia, UAE, Israel, etc.). - **Supported regions**: Use ISO3 codes or common names. No separate region aggregation endpoint; individual country queries only. - **Demographic transition analysis**: Automatically included when aspect is `"all"`, `"growth"`, or `"fertility"`. Classifies countries into 5 stages: Stage 1 (High Stationary), Stage 2 (Early Expanding), Stage 3 (Late Expanding), Stage 4 (Low Stationary), Stage 5 (Declining). - **Dependency ratios**: When `calculate_dependency_ratios` is true and aspect is `"all"` or `"age"`, the tool returns age dependency ratio, youth dependency ratio, and elderly dependency ratio (dependents per 100 working-age persons). If API-provided ratios are unavailable, they are calculated from age structure percentages. - **Urban/rural split**: When `include_urban_rural` is true, returns urban and rural percentages plus an urbanization level classification (Highly urbanized >= 80%, Moderately urbanized >= 60%, Partially urbanized >= 40%, Predominantly rural < 40%). - **Age structure interpretation**: Included when aspect is `"all"` or `"age"`. Categorizes population as "Very young" (youth > 40%), "Young" (youth > 30%), "Aging" (elderly > 20%), "Mature" (elderly > 14%), or "Balanced", with estimated median age range and policy implications. - **Replacement fertility**: The tool flags whether the fertility rate is below the replacement level of 2.1 births per woman. - **Data availability**: World Bank data may lag 1-3 years behind the current year. Some indicators may not be available for all countries or years. - **Values are rounded** to 2 decimal places where applicable. - **time_period validation**: Accepts `"latest"`, `"last5"`, `"last10"`, a 4-digit year, or a `YYYY:YYYY` range. Invalid formats return a validation error. - **Unrecognized countries** return a descriptive error suggesting valid country names or ISO3 codes. - **Data source**: World Bank Data360 API (World Development Indicators), updated regularly. ### Frequently Asked Questions #### How do I connect this tool to an external agent? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md You can install the local MCP server by opening a terminal and running: ``` npm install -g @agentpmt/mcp-router agentpmt-setup ``` This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc. Alternatively you can connect to the hosted version with this config block, no installation required: ``` { "mcpServers": { "agentpmt": { "type": "streamable-http", "url": "https://api.agentpmt.com/mcp", "headers": { "Authorization": "Bearer ", "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}" } } } } ``` [View MCP Connection Instructions](/docs/mcp-reference/connection) for more details. #### How does an external agent use this tool? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent: > Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get\_instructions' so you know how to use the tool search interface. Then call action 'get\_schema' with tool\_id 6980e0f571cad8f61bf5b1fb ("Global Population & Demographics Data"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT. ### Dependencies This product has no public dependency products.