TalentPulse

{
  "properties": {
    "company_size": {
      "description": "startup | series-b | mid-market | large-cap | public (optional)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "country": {
      "description": "Country e.g. USA | UK | Germany | Singapore | Australia | Canada (default: USA)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "level": {
      "description": "Level: C-suite | VP | Director | Senior Director | SVP (default: VP)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "role": {
      "description": "Role e.g. CEO | CFO | CTO | VP Engineering | General Counsel | Chief Revenue Officer",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "sector": {
      "description": "Industry sector e.g. SaaS | fintech | healthcare | manufacturing | consulting (default: technology)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "role"
  ],
  "type": "object"
}

{
  "properties": {
    "countries": {
      "description": "Comma-separated list of countries (min 2) e.g. USA,India,Poland,Colombia",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "experience": {
      "description": "Experience level (default: mid)",
      "enum": [
        "entry",
        "mid",
        "senior"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "role": {
      "description": "Role to compare e.g. software engineer | data analyst | customer support manager | accountant",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "role",
    "countries"
  ],
  "type": "object"
}

{
  "properties": {
    "country": {
      "description": "Country to model e.g. Brazil | Germany | Philippines | India | Mexico | Poland",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "salary": {
      "description": "Annual gross salary in local currency (optional, for cost model)",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "country"
  ],
  "type": "object"
}

{
  "properties": {
    "industry": {
      "description": "Industry sector e.g. tech | finance | retail | healthcare | media | logistics (default: tech)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Geographic focus e.g. USA | Europe | Asia | Global (default: Global)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

{
  "properties": {
    "company_country": {
      "description": "Where the employer entity is based (optional, affects PE analysis)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "country": {
      "description": "Country where remote employee is located e.g. Germany | Brazil | India | Philippines",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "nationality": {
      "description": "Nationality of the remote employee (optional)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "country"
  ],
  "type": "object"
}

{
  "properties": {
    "country": {
      "description": "Country name — optional, inferred from location if omitted",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "currency": {
      "description": "Preferred currency code e.g. USD | GBP | EUR | SGD | INR | AUD | CAD",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "experience": {
      "description": "Experience filter (default: all)",
      "enum": [
        "entry",
        "mid",
        "senior",
        "all"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language: en | es | fr | de | ja | zh | ko | pt | ar | hi (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "location": {
      "description": "City or region e.g. London | Singapore | São Paulo | Dubai | Bangalore | Toronto",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "role": {
      "description": "Job title e.g. Software Engineer | Data Scientist | Product Manager | Registered Nurse",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "role",
    "location"
  ],
  "type": "object"
}

{
  "properties": {
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Geographic focus e.g. Southeast Asia | Europe | North America | MENA | Latin America | Global (default: Global)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "skills": {
      "description": "Skills or role e.g. machine learning | React | Kubernetes | product management",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "skills"
  ],
  "type": "object"
}

{
  "properties": {
    "country": {
      "description": "Country e.g. USA | UK | India | Germany | Australia | Nigeria | Brazil",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "industry": {
      "description": "Industry e.g. healthcare | manufacturing | technology | financial services | construction",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "industry",
    "country"
  ],
  "type": "object"
}

{
  "properties": {
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "region": {
      "description": "Region or country e.g. Southeast Asia | Germany | Sub-Saharan Africa | Latin America | Middle East",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "role": {
      "description": "Role or discipline e.g. DevOps Engineer | nurse | financial analyst | mechanical engineer",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "role",
    "region"
  ],
  "type": "object"
}

{
  "properties": {
    "destination": {
      "description": "Country where they want to work e.g. Canada | Germany | UAE | Australia | UK | Singapore",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "lang": {
      "description": "Response language (default: en)",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "nationality": {
      "description": "Nationality of the worker e.g. Indian | American | Brazilian | Nigerian | Filipino",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "role": {
      "description": "Job role — optional, helps identify role-specific visa pathways",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "nationality",
    "destination"
  ],
  "type": "object"
}