{ "openapi": "3.1.0", "info": { "title": "TalentPulse API", "description": "Global workforce intelligence API — salary benchmarks, remote compliance, EOR cost models, skills demand, work visas, talent market analysis, executive compensation, layoff tracking, skills gap analysis, and multi-country hiring cost comparison. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.", "version": "1.0.0", "contact": { "url": "https://talentpulse-six.vercel.app" } }, "servers": [ { "url": "https://talentpulse-six.vercel.app" } ], "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 payment signature. Send a GET request without this header to receive a 402 with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.", "required": true } } }, "security": [ { "x402": [] } ], "paths": { "/api/talent/salary": { "get": { "summary": "Salary benchmarking — any role, any location globally", "description": "Returns salary bands by experience tier (entry/mid/senior), USD equivalents, bonus/equity norms, and market context for any job role in any city or country globally. Supports 10 languages.", "operationId": "getSalary", "parameters": [ { "name": "role", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Job title e.g. Software Engineer | Data Scientist | Product Manager | Registered Nurse" }, { "name": "location", "in": "query", "required": true, "schema": { "type": "string" }, "description": "City or region e.g. London | Singapore | São Paulo | Dubai | Bangalore | Toronto" }, { "name": "country", "in": "query", "schema": { "type": "string" }, "description": "Country name — optional, inferred from location if omitted" }, { "name": "experience", "in": "query", "schema": { "type": "string", "enum": ["entry", "mid", "senior", "all"] }, "description": "Experience filter (default: all)" }, { "name": "currency", "in": "query", "schema": { "type": "string" }, "description": "Preferred currency code e.g. USD | GBP | EUR | SGD | INR | AUD | CAD" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language: en | es | fr | de | ja | zh | ko | pt | ar | hi (default: en)" } ], "responses": { "200": { "description": "Salary benchmark JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.15 USDC)" } }, "x-price-usdc": 0.15, "x-model": "claude-haiku-4-5-20251001" } }, "/api/talent/remote-compliance": { "get": { "summary": "Remote work compliance — jurisdiction-specific legal intelligence", "description": "Returns permanent establishment risk, contractor classification risk, mandatory obligations, EOR viability, and recommended employment structure for hiring remote employees in 60+ countries.", "operationId": "getRemoteCompliance", "parameters": [ { "name": "country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Country where remote employee is located e.g. Germany | Brazil | India | Philippines" }, { "name": "nationality", "in": "query", "schema": { "type": "string" }, "description": "Nationality of the remote employee (optional)" }, { "name": "company_country", "in": "query", "schema": { "type": "string" }, "description": "Where the employer entity is based (optional, affects PE analysis)" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Remote compliance JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.20 USDC)" } }, "x-price-usdc": 0.20, "x-model": "claude-sonnet-4-6" } }, "/api/talent/employer-of-record": { "get": { "summary": "Employer of record cost model — full employer cost breakdown by country", "description": "Returns employer tax burden, mandatory benefits, termination framework, and EOR vs entity analysis for hiring full-time employees in any country globally.", "operationId": "getEmployerOfRecord", "parameters": [ { "name": "country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Country to model e.g. Brazil | Germany | Philippines | India | Mexico | Poland" }, { "name": "salary", "in": "query", "schema": { "type": "number" }, "description": "Annual gross salary in local currency (optional, for cost model)" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "EOR cost model JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.20 USDC)" } }, "x-price-usdc": 0.20, "x-model": "claude-sonnet-4-6" } }, "/api/talent/skills-demand": { "get": { "summary": "Skills demand intelligence — real-time market signal for any skill or role globally", "description": "Returns demand level, trajectory, salary premium, global hot spots, and emerging vs declining skill context for any skill set or role, with regional focus.", "operationId": "getSkillsDemand", "parameters": [ { "name": "skills", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Skills or role e.g. machine learning | React | Kubernetes | product management" }, { "name": "region", "in": "query", "schema": { "type": "string" }, "description": "Geographic focus e.g. Southeast Asia | Europe | North America | MENA | Latin America | Global (default: Global)" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Skills demand JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.12 USDC)" } }, "x-price-usdc": 0.12, "x-model": "claude-haiku-4-5-20251001" } }, "/api/talent/visa": { "get": { "summary": "Work visa intelligence — all pathways for any nationality/destination pair", "description": "Returns all available work visa types, salary thresholds, processing times, digital nomad visa availability, intracompany transfer options, and permanent residence pathways for any nationality/destination combination.", "operationId": "getVisa", "parameters": [ { "name": "nationality", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Nationality of the worker e.g. Indian | American | Brazilian | Nigerian | Filipino" }, { "name": "destination", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Country where they want to work e.g. Canada | Germany | UAE | Australia | UK | Singapore" }, { "name": "role", "in": "query", "schema": { "type": "string" }, "description": "Job role — optional, helps identify role-specific visa pathways" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Work visa options JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.15 USDC)" } }, "x-price-usdc": 0.15, "x-model": "claude-haiku-4-5-20251001" } }, "/api/talent/talent-market": { "get": { "summary": "Talent market intelligence — supply/demand dynamics, hubs, and competitive landscape", "description": "Returns supply/demand tension, talent hub cities, hiring difficulty, immigration contribution, and competitive landscape for any role and region globally.", "operationId": "getTalentMarket", "parameters": [ { "name": "role", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Role or discipline e.g. DevOps Engineer | nurse | financial analyst | mechanical engineer" }, { "name": "region", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Region or country e.g. Southeast Asia | Germany | Sub-Saharan Africa | Latin America | Middle East" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Talent market intelligence JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.15 USDC)" } }, "x-price-usdc": 0.15, "x-model": "claude-haiku-4-5-20251001" } }, "/api/talent/compensation": { "get": { "summary": "Executive compensation benchmarking — total comp for senior and C-suite roles globally", "description": "Returns base salary percentiles (P25/P50/P75/P90), STI/bonus structure, LTI/equity norms, benefits, and total target compensation for senior and C-suite roles across major markets.", "operationId": "getCompensation", "parameters": [ { "name": "role", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Role e.g. CEO | CFO | CTO | VP Engineering | General Counsel | Chief Revenue Officer" }, { "name": "level", "in": "query", "schema": { "type": "string" }, "description": "Level: C-suite | VP | Director | Senior Director | SVP (default: VP)" }, { "name": "sector", "in": "query", "schema": { "type": "string" }, "description": "Industry sector e.g. SaaS | fintech | healthcare | manufacturing | consulting (default: technology)" }, { "name": "country", "in": "query", "schema": { "type": "string" }, "description": "Country e.g. USA | UK | Germany | Singapore | Australia | Canada (default: USA)" }, { "name": "company_size", "in": "query", "schema": { "type": "string" }, "description": "startup | series-b | mid-market | large-cap | public (optional)" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Executive compensation benchmark JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.25 USDC)" } }, "x-price-usdc": 0.25, "x-model": "claude-sonnet-4-6" } }, "/api/talent/layoffs": { "get": { "summary": "Layoff tracker — real-time workforce reduction intelligence", "description": "Returns layoff intensity, trend, company-level signals, what talent is now available, and who is counter-hiring for any industry and region globally.", "operationId": "getLayoffs", "parameters": [ { "name": "industry", "in": "query", "schema": { "type": "string" }, "description": "Industry sector e.g. tech | finance | retail | healthcare | media | logistics (default: tech)" }, { "name": "region", "in": "query", "schema": { "type": "string" }, "description": "Geographic focus e.g. USA | Europe | Asia | Global (default: Global)" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Layoff intelligence JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.10 USDC)" } }, "x-price-usdc": 0.10, "x-model": "claude-haiku-4-5-20251001" } }, "/api/talent/skills-gap": { "get": { "summary": "Skills gap intelligence — where employer demand outpaces supply, with reskilling pathways", "description": "Returns gap severity, critical skill gaps with root causes, government upskilling initiatives, and ROI-ranked reskilling recommendations for any industry and country globally.", "operationId": "getSkillsGap", "parameters": [ { "name": "industry", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Industry e.g. healthcare | manufacturing | technology | financial services | construction" }, { "name": "country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Country e.g. USA | UK | India | Germany | Australia | Nigeria | Brazil" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Skills gap intelligence JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.15 USDC)" } }, "x-price-usdc": 0.15, "x-model": "claude-haiku-4-5-20251001" } }, "/api/talent/cost-comparison": { "get": { "summary": "Multi-country hiring cost comparison — CFO-grade employer cost model across countries", "description": "Returns total annual employer cost in USD for the same role across multiple countries, covering salary, employer tax burden, mandatory benefits, and talent quality tier assessment.", "operationId": "getCostComparison", "parameters": [ { "name": "role", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Role to compare e.g. software engineer | data analyst | customer support manager | accountant" }, { "name": "countries", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Comma-separated list of countries (min 2) e.g. USA,India,Poland,Colombia" }, { "name": "experience", "in": "query", "schema": { "type": "string", "enum": ["entry", "mid", "senior"] }, "description": "Experience level (default: mid)" }, { "name": "lang", "in": "query", "schema": { "type": "string" }, "description": "Response language (default: en)" } ], "responses": { "200": { "description": "Multi-country cost comparison JSON" }, "402": { "description": "Payment required — x402 micropayment ($0.20 USDC)" } }, "x-price-usdc": 0.20, "x-model": "claude-haiku-4-5-20251001" } } } }