{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"aa7cf33d-61c6-4c3a-ad2c-2f47bdc4e027","name":"Claro API Reference Library","description":"Our API URL: [https://apijavaanalytics.claro.hr/2.0.0/](https://apijavaanalytics.claro.hr/2.0.0/)\n\n\\*_New version as of March 27, 2024, be sure to use the 2.0.0 url above to send requests.\\*_<u><br>Previous API Documentation:<br></u>[v1.0.1](https://documenter.getpostman.com/view/27650649/2sA35EZhUg)  \n[v1.0.0](https://documenter.getpostman.com/view/27983126/2sA35Ba3tK)\n\n# Authorization\n\nWe authorize access to Claro's API endpoints via [JSON Web Token](https://en.wikipedia.org/wiki/JSON_Web_Token). Your account manager will issue you a unique client_id and client_secret key after your Administrator user account is created. To generate your unique access token, send a request to the url above using your unique client_id and client_secret combination, as explained in the [Requesting a Bearer Token](https://apidocs.claro.hr/#fd2bc6ec-cd62-481a-8dfe-30de90b83fd1) section below.\n\n# Errors\n\nWe use conventional HTTP response codes to indicate the state (success or failure) of an API request.\n\nIn general:\n\nCodes in the 2xx range indicate successful operation.\n\nCodes in the 4xx range indicate an error based on the information entered  \n(e.g., a required parameter is missing, wrong query logic, or an actual endpoint is nonexistent).  \nYou can find examples below in [query errors](#queries) or in [400 Error Messages](##400-Error-Messages).\n\nCodes in the 5xx range indicate errors with our servers or network issues.\n\nMore general information on error codes can be found [here](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes).\n\n# Queries\n\n## Query Errors\n\nHere is an example of the system returning an error:\n\n```\n{\n  \"timestamp\": \"2020-06-03T07:16:25.165+0000\",\n  \"status\": 400,\n  \"error\": \"Bad Request\",\n  \"message\": \"Value of operator text must be in range! Array size must be 1!\",\n  \"path\": \"/supplyData/barData/industry\"\n}\n\n ```\n\n`timestamp` - date and time when the error occurred.\n\n`status` - HTTP response code.\n\n`message` - specific error description.\n\n`path` - query URI.\n\nHere are some common error messages with HTTP status code 400:\n\nValue of operator text must be in range! Array size must be 1!\n\nValue of parameterType is invalid!\n\nValue of parameterKey is invalid!\n\nValue of operator text must be in range! Array size must be 2!\n\nBoth range token values must be integers!\n\nValue of operator bool must be Boolean!\n\nOperator must be one of the following: AND, OR, NOT, (, )!\n\nWrong query logic. Check operators.\n\n## Query Logic\n\nData from our API is queried using JSON, and we use a Claro proprietary syntax for entering values. Parameters are called [tokens](#tokens).\n\nHere is an example query of a Heat Map, using several [tokens](#tokens) to optimize data extraction:\n\n```\n{\n    \"searchParameters\": [\n        {\n            \"parameterValue\": [\n                \"US\"\n            ],\n            \"parameterType\": \"text\",\n            \"parameterKey\": \"country\"\n        },\n        {\n            \"parameterValue\": [\n                \"AND\"\n            ],\n            \"parameterType\": \"operator\",\n            \"parameterKey\": \"AND\"\n        },\n        {\n            \"parameterValue\": [\n                \"shop\"\n            ],\n            \"parameterType\": \"text\",\n            \"parameterKey\": \"companyCurrent\"\n        }\n    ],\n    \"topLeft\": {\n        \"lat\": 57.42129439209407,\n        \"lon\": -140.36132812500003\n    },\n    \"bottomRight\": {\n        \"lat\": 8.928487062665504,\n        \"lon\": -61.25976562500001\n    }\n}\n\n ```\n\nThe above query will yield the following prospects:  \n`People who live in the US AND currently work at shop`\n\nThe order of non-operator tokens does not affect the performance of the call to the database, i.e. US AND shop = shop AND US.\n\nThe parameters `topLeft` and `bottomRight` are unique to the Heat Map, for they represent the minimum size of the map needed to contain all prospects/jobs from the search. For more info on the Heat Map, look for the [Heat Map Area Endpoint](#Heat-Map-Area-Endpoint) description. Other presentations of data will have other unique parameters, e.g. bars for bar chart, slices for pie chart, etc.\n\nHere is an example of an error. This search will yield an error for invalid query logic because all operators require that another non-operator token exists after them in the string:\n\n``` json\n{\n    \"searchParameters\": [\n        {\n            \"parameterValue\": [\n                \"US\"\n            ],\n            \"parameterType\": \"text\",\n            \"parameterKey\": \"country\"\n        },\n        {\n            \"parameterValue\": [\n                \"OR\"\n            ],\n            \"parameterType\": \"operator\",\n            \"parameterKey\": \"OR\"\n        }\n    ]\n}\n\n ```\n\nError response:\n\n``` json\n{\n    \"timestamp\": \"2020-06-03 10:48:34.675\",\n    \"status\": 400,\n    \"error\": \"Payload error\",\n    \"message\": \"Wrong query logic. Check operators.\",\n    \"path\": \"/supplyData/barData/country\"\n}\n\n ```\n\n# Tokens\n\nTokens represent search parameters. The three types of tokens are: operators (also referred to as logical tokens), supply filters, and demand filters. To read more about each type, go to [Logical tokens](#logical-tokens), [Talent Supply Insights](#talent-supply-insights), or [Talent Demand Insights](#talent-demand-insights). \"Filters\" refers to both supply and demand filters.\n\nHere is the JSON representation of a single Country code token:\n\n``` json\n{\n    \"parameterValue\": [\n        \"US\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"country\"\n}\n\n ```\n\nAll tokens consist of:\n\n`parameterValue` - value is an array with one element (array\\[0\\]) as the value being used for search. As of right now, the only exception is the salary token, which requires first (array\\[0\\]) and second (array\\[1\\]) element as values.\n\n`parameterType` - value is an enumerated string (varchar), which can be one of:\n\n`text`, `fields`, `bool`, `range`, `operator`.\n\n`text` - value must be entered to successfully resolve.\n\n`fields` - similar to text, but allows for searching more complex information. Currently, this type is only used for experience tokens.\n\n`bool` - value is default to `true`, if `NOT` operator is used, then the value is `false`.\n\n`range` - value must contain 2 entries of information to successfully resolve.\n\n`operator` - value relates the `bool` and/or `text` and/or `range` tokens before and after it.\n\n`parameterKey` - value is an enumerated string (varchar). All possible values will be provided below, and all possible tokens will be described. Using `parameterKey` other than those listed below will result in an error.\n\n# Logical Tokens\n\nTo perform a search using multiple filters, use the boolean operators found below.\n\n**AND** - operator only returns prospects/jobs where ALL of the filter values exist within the search fields of any single record.  \nExample: `\"Country code\":\"US\" AND \"Current Employer\":\"shop\"` will only return prospects living in the United States who also work at shop. The results occupy the intersection of the filters.\n\n``` json\n{\n  \"searchParameters\": [\n      {\n        \"parameterValue\": [\n          \"US\"\n        ],\n        \"parameterType\": \"text\",\n        \"parameterKey\": \"country\"\n      },\n      {\n        \"parameterValue\": [\n          \"AND\"\n        ],\n        \"parameterType\": \"operator\",\n        \"parameterKey\": \"AND\"\n      },\n      {\n        \"parameterValue\": [\n          \"shop\"\n        ],\n        \"parameterType\": \"text\",\n        \"parameterKey\": \"companyCurrent\"\n      }\n    ]\n}\n\n ```\n\n**OR** - operator returns prospects/jobs where ANY of the filter values exist within the search fields of any single record.  \nExample: `\"Country code\":\"US\" OR \"Current Employer\":\"shop\"` will return ALL prospects living in United States, and ALL prospects who currently work at shop. The intersection of the two search filters does not affect the results.\n\n``` json\n{\n  \"searchParameters\": [\n    {\n      \"parameterValue\": [\n        \"US\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"country\"\n    },\n    {\n      \"parameterValue\": [\n        \"OR\"\n      ],\n      \"parameterType\": \"operator\",\n      \"parameterKey\": \"OR\"\n    },\n    {\n      \"parameterValue\": [\n        \"shop\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"companyCurrent\"\n    }\n  ]\n}\n\n ```\n\n**NOT** - The NOT operator returns ALL prospects/jobs that do not contain the term after NOT. For all \"bool\" parameter types, NOT filters for the `false` condition.  \nExample: `\"Country code\":\"US\" AND NOT \"Current Employer\":\"shop\"`  \nwill return ALL prospects who live in the United States, but do not currently work at shop.\n\n``` json\n{\n  \"searchParameters\": [\n    {\n      \"parameterValue\": [\n        \"US\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"country\"\n    },\n    {\n      \"parameterValue\": [\n        \"AND\"\n      ],\n      \"parameterType\": \"operator\",\n      \"parameterKey\": \"AND\"\n    },\n    {\n      \"parameterValue\": [\n        \"NOT\"\n      ],\n      \"parameterType\": \"operator\",\n      \"parameterKey\": \"NOT\"\n    },\n    {\n      \"parameterValue\": [\n        \"shop\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"companyCurrent\"\n    }\n  ]\n}\n\n ```\n\n**Grouping (parentheses)** - The parentheses operators allow you to group filters and other operators. This is typically used when you want to find prospects/jobs with many similar criteria, but one key difference.  \nExample: `\"Country code\":\"US\" AND (\"Current Employer\":\"shop\" OR \"Current Employer\":\"Bank\")`, will return prospects who live in the United States, and who either work at shop or work at Bank. You can add many terms within the parentheses, use multiple sets of parentheses in one string, and even use parentheses to group filters within a larger set of parentheses.\n\n``` json\n{\n  \"searchParameters\": [\n    {\n      \"parameterValue\": [\n        \"US\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"country\"\n    },\n    {\n      \"parameterValue\": [\n        \"AND\"\n      ],\n      \"parameterType\": \"operator\",\n      \"parameterKey\": \"AND\"\n    },\n    {\n      \"parameterValue\": [\n        \"(\"\n      ],\n      \"parameterType\": \"operator\",\n      \"parameterKey\": \"(\"\n    },\n    {\n      \"parameterValue\": [\n        \"shop\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"companyCurrent\"\n    },\n    {\n      \"parameterValue\": [\n        \"OR\"\n      ],\n      \"parameterType\": \"operator\",\n      \"parameterKey\": \"OR\"\n    },\n    {\n      \"parameterValue\": [\n        \"Bank\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"companyCurrent\"\n    },\n    {\n      \"parameterValue\": [\n        \")\"\n      ],\n      \"parameterType\": \"operator\",\n      \"parameterKey\": \")\"\n    }\n  ]\n}\n\n ```\n\n# Talent Supply Insights\n\nThe following list of tokens represent ways to find prospects around the world. You can use many supply filters joined by operators, or just singular filter searches to accomplish this task, but you CANNOT use Talent Supply Insights tokens and Talent Demand Insights tokens in the same query. Be sure to match the \"parameterType\" and \"parameterKey\" to the exact characters listed below.\n\n## Alerts\n\n**Prospects who have alerts set.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"alerts\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\n## Active\n\n**Prospects who have alerts set AND are currently showing job-seeking activity.**\n\n```\n{\n     \"parameterValue\": [\n        \"ACTIVE\"\n     ],\n     \"parameterType\": \"bool\",\n     \"parameterKey\": \"ACTIVE\"\n}\n\n ```\n\n`parameterValue` - must be exactly `ACTIVE` to return data.  \nSingle array element.\n\n---\n\n## Military\n\n**Prospects who are currently on active duty or veterans.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"military\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\n## Clearance\n\n**Prospects who have active TS security clearance.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"clearance\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\n## Diversity\n\n**Prospects who are from diverse ethnic backgrounds.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"diversity\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\n## Male\n\n**Prospects who are MALE gender.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"male\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\n## Female\n\n**Prospects who are FEMALE gender.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"female\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\n## Email\n\n**Prospects who have emails available in the database.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"email\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\nThe following tokens (CBSA - SKILLS) all require a value input for the chosen parameter in order to return results successfully. You can use the NOT operator to search for everything EXCEPT the entered value, for any of the subsequent supply and demand filters.\n\n## CBSA\n\n**Prospects who are located in a** [<b>Core-Based Statistical Area</b>](https://en.wikipedia.org/wiki/Core-based_statistical_area) **that exactly matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"New Bern, NC\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"cbsa\"\n}\n\n ```\n\n`parameterValue` - varchar value, must be exact CBSA value.\n\n---\n\n## Country Code\n\n**Prospects who are located in a country that exactly matches your entered value. We use the ISO3166 Alpha 2 letter** [<b>country codes.</b>](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n\n```\n{\n    \"parameterValue\": [\n        \"US\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"country\"\n}\n\n ```\n\n`parameterValue` - varchar (2). [Values are in exact ISO3166 Alpha 2 codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements). Single array element.\n\n---\n\n## Current Employer\n\n**Prospects who are currently working for the company which matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"IBM\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"companyCurrent\"\n}\n\n ```\n\n`parameterValue` - varchar, any existing company. Single array element.\n\n---\n\n## Current Experience\n\n**Prospects who have experience in their current job which matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"Symfony\"\n    ],\n    \"parameterType\": \"fields\",\n    \"parameterKey\": \"experienceCurrent\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Current Title\n\n**Prospects who have a current job title that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"CTO\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"currentTitle\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Education\n\n**Prospects who have attained a degree or attended a college that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"Bachelor\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"education\"\n}\n\n ```\n\n`parameterValue` - varchar, any degree or school name. Single array element.\n\n---\n\n## Industry\n\n**Prospects who are currently working in a field of labor that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"IT\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"industry\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Language\n\n**Prospects who have proficiency in a language that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"german\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"languagesList\"\n}\n\n ```\n\n`parameterValue` - varchar, must use the english spelling. Single array element.\n\n---\n\n## Location\n\n**Prospects who are based out of a particular city, state, country, or combination of the three, as per the value(s) you enter.**\n\n```\n{\n    \"parameterValue\": [\n        \"Boston\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"location\"\n}\n\n ```\n\n`parameterValue` - varchar, any city, state, country, or combination (for best results finding a given city, include a [country code](##country-code) token in the same query). Single array element.\n\n---\n\n## Name\n\n**Prospects who have a first and/or last name that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"Lukas\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"fullName\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Occupation\n\n**Prospects who are currently working within the occupation which matches your entered value.**\n\n```\n{\n    \"searchParameters\": [\n        {\n            \"parameterValue\": [\n                \"Software Developers\",\n                \"Principal Software Engineer\"\n            ],\n            \"parameterType\": \"text\",\n            \"parameterKey\": \"currentTitleMerged\"\n        }\n    ]\n}\n\n ```\n\n`parameterValue` - varchar. Multiple array element. Use the [Occupation Autocomplete Endpoint](https://apidocs.claro.hr/#210d0058-a7ac-45e4-8f4b-601620db933e) to find the exact Occupation values needed for this token.\n\nWhen supplying a parameterValue, you'll have to supply the parent and child occupation of interest.\n\nIf you want to conduct a search against a parent occupation, only the parent occupation is required.\n\nFor Example:\n\n\\[\"parentOccupation\",\"childOccupation\"\\]\n\nor\n\n\\[\"parentOccupation\"\\]\n\n---\n\n## Previous Employer\n\n**Prospects who have worked at the company you entered, prior to their current job.**\n\n```\n{\n    \"parameterValue\": [\n        \"Faktory\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"companyPrevious\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Previous Experience\n\n**Prospects who have experience in a prior job that matches your entered value(s).**\n\n```\n{\n    \"parameterValue\": [\n        \"group leader\"\n    ],\n    \"parameterType\": \"fields\",\n    \"parameterKey\": \"experiencePrevious\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Previous Title\n\n**Prospects who had a title at a prior job that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"CEO\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"titlePrevious\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Professional Headline\n\n**Prospects who have a professional headline that contains your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"Head of HR\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"na_headline\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Radius\n\n**Prospects who are based out of a location within the radius corresponding to your entered values. All values are measured in mi (miles) or km (kilometers), and only whole number distance values are accepted.**\n\n```\n    {\n      \"parameterValue\": [\n        \"San Francisco, CA, USA\",\n        \"10\",\n        \"mi\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"locationRange\"\n    }\n\n ```\n\n`parameterValue` - varchar. Single array element. Use the [Radius Autocomplete Endpoint](#radius-autocomplete-endpoint-supply) to find the exact location values needed for this token.\n\n---\n\n## Timezone\n\n**Prospects who are based out of a timezone that exactly matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"Pacific Standard Time\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"timezone\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element. Value must be exact match for valid value. List of valid Values = Baker Island Time, Samoa Standard Time, Hawaii-Aleutian Standard Time, GMT -9.5, Alaska Standard Time, Pacific Standard Time, Mountain Standard Time, Central Standard Time, Eastern Standard Time, Atlantic Standard Time, GMT -3.5, Brasilia Time, Fernando de Noronha Time, Cape Verde Time, Greenwich Mean Time, Central European Time, Eastern European Time, Moscow Time, GMT +3.5, Gulf Standard Time, GMT +4.5, Pakistan Standard Time, GMT +5.5, GMT +5.75, Bangladesh Standard Time, GMT +6.5, Western Indonesian Time, China Standard Time, GMT +8.5, Japan Standard Time, GMT +9.5, Australian Eastern Standard Time, GMT +10.5, Solomon Islands Time, GMT +11.5, New Zealand Standard Time, New Zealand Daylight Time, Line Islands Time\n\n---\n\n## Free Text\n\n**This token is unique. Using Lucene Query Syntax, you can find prospects matching any other token, and more. Go to** [https://analytics.claro.hr/support/free-text-button-help](https://analytics.claro.hr/support/free-text-button-help) **to find out more.**\n\n```\n{\n    \"parameterValue\": [\n        \"PHP\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"lucene\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Skills\n\n**Prospects who are proficient in a skill that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"C++\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"skills\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## About\n\n**Prospects who have info in their About section on LinkedIn that matches your entered value.**\n\n```\n{\n      \"parameterValue\": [\n          \"attorney\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"about\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Region\n\n**Prospects who live in a group of countries that matches your entered value. Use Value \"AMER\" to show the Americas, \"APAC\" to show Asia Pacific, and \"EMEA\" to show Europe, the Middle East and Africa.**\n\n```\n{\n      \"parameterValue\": [\n          \"APAC\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"region\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n# Talent Demand Insights\n\nThe following list of tokens represent ways to find job postings around the world. You can use many demand filters joined by operators, or just singular filter searches to accomplish this task, but you CANNOT use Talent Demand Insights tokens and Talent Supply Insights tokens in the same query.\n\n## CBSA\n\n**Job availabilities located in a Core-Based Statistical Area that exactly matches your entered value. (**[<b>https://en.wikipedia.org/wiki/Core-based_statistical_area</b>](https://en.wikipedia.org/wiki/Core-based_statistical_area)**)**\n\n```\n{\n    \"parameterValue\": [\n        \"New York-Newark-Jersey City, NY-NJ-PA\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"jobCbsa\"\n}\n\n ```\n\n`parameterValue` - varchar value, must be exact CBSA value.\n\n---\n\n## Company\n\n**Job availabilities at a company that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"Apple\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"jobCompany\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Country code\n\n**Job availabilities located in a country that exactly matches your entered value, using ISO3166 Alpha 2 codes. (**[<b>https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements</b>](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)**)**\n\n```\n{\n    \"parameterValue\": [\n        \"LT\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"jobCountry\"\n}\n\n ```\n\n`parameterValue` - varchar (2). [Values are in exact ISO3166 Alpha 2 codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements). Single array element.\n\n---\n\n## Description\n\n**Job availabilities with information in the description that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"accredited\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"jobDescription\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Location\n\n**Job availabilities located in a city, state, country, or combination of the three, that matches your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"London\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"jobLocation\"\n}\n\n ```\n\n`parameterValue` - varchar, any city, state, country, or combination (for best results finding a given city, include a [country code](#country-code) token in the same query). Single array element.\n\n---\n\n## Occupation\n\n**Job availabilities within the Occupation that matches your entered value.**\n\n```\n{\n    \"searchParameters\": [\n        {\n            \"parameterValue\": [\n                \"Software Developers\",\n                \"Principal Software Engineer\"\n            ],\n            \"parameterType\": \"text\",\n            \"parameterKey\": \"currentTitleMerged\"\n        }\n    ]\n}\n\n ```\n\n`parameterValue` - varchar. Multiple array element. Use the [Occupation Autocomplete Endpoint](https://apidocs.claro.hr/#07cae004-2ab2-4019-a045-89ffa6e37e9d) to find the exact Occupation values needed for this token.\n\nWhen supplying a parameterValue, you'll have to supply the parent and child occupation of interest.\n\nIf you want to conduct a search against a parent occupation, only the parent occupation is required.\n\nFor Example:\n\n\\[\"parentOccupation\",\"childOccupation\"\\]\n\nor\n\n\\[\"parentOccupation\"\\]\n\n---\n\n## Position\n\n**Job availabilities where the name of the position includes your entered value.**\n\n```\n{\n    \"parameterValue\": [\n        \"CTO\"\n    ],\n    \"parameterType\": \"text\",\n    \"parameterKey\": \"jobPosition\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n## Radius\n\n**Job availabilities that are based out of a location within the radius corresponding to your entered values. All values are measured in mi (miles) or km (kilometers), and only whole number distance values are accepted.**\n\n```\n    {\n      \"parameterValue\": [\n        \"New York, NY, USA\",\n        \"10\",\n        \"km\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"locationRange\"\n    }\n\n ```\n\n`parameterValue` - varchar. Single array element. Use the [Radius Autocomplete Endpoint](#radius-autocomplete-endpoint-demand) to find the exact location values needed for this token.\n\n---\n\n## Clearance\n\n**Job availabilities that require active TS security clearance.**\n\n```\n{\n    \"parameterValue\": [],\n    \"parameterType\": \"bool\",\n    \"parameterKey\": \"jobClearance\"\n}\n\n ```\n\n`parameterValue` - empty array represents `true`. For `false` use [NOT](#logical-tokens) operator before token.\n\n---\n\n## Salary\n\n**Job availabilities that are within the salary range you enter. Enter the lower value first, then the higher value. Use only integers.**\n\n```\n{\n    \"parameterValue\": [\n        \"500\",\n        \"5000\"\n    ],\n    \"parameterType\": \"range\",\n    \"parameterKey\": \"jobSalary\"\n}\n\n ```\n\n`parameterValue` - array of integers representing range. First (array\\[0\\]) element represents FROM, second (array\\[1\\]) element represents TO.\n\n---\n\n## Region\n\n**Job postings that originate in a group of countries that matches your entered value. Use Value \"AMER\" to show the Americas, \"APAC\" to show Asia Pacific, and \"EMEA\" to show Europe, the Middle East and Africa.**\n\n```\n{\n      \"parameterValue\": [\n          \"AMER/APAC/EMEA\"\n      ],\n      \"parameterType\": \"text\",\n      \"parameterKey\": \"region\"\n}\n\n ```\n\n`parameterValue` - varchar. Single array element.\n\n---\n\n# Charts\n\nWe currently support responses to create bar charts, pie charts, data lists, and heat maps. You can use the above search taxonomy to receive responses from multiple of the below endpoints.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"11291662","collectionId":"aa7cf33d-61c6-4c3a-ad2c-2f47bdc4e027","publishedId":"T17Ke7D1","public":true,"publicUrl":"https://apidocs.claro.hr","privateUrl":"https://go.postman.co/documentation/11291662-aa7cf33d-61c6-4c3a-ad2c-2f47bdc4e027","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.11.11","publishDate":"2020-07-09T13:20:16.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":"https://claro.hr/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://apidocs.claro.hr/view/metadata/T17Ke7D1"}