Rate Limits 

“Rate limit” refers to the number of API calls the client (API consumer) can make in a certain time frame. To ensure equitable usage, TalentNeuron incorporates API Rate Limits in the form of Call Units per minute, with different APIs associated with different “Call Unit” allotments. TalentNeuron allows for a Rate Limit of up to a certain number of allowed Call Units per minute. The majority of Talent Intelligence APIs have a Call Unit value of 1 per API call, supporting up to 120 calls per minute.  

Once the Rate Limit is exceeded, any subsequent requests made by your API will fail with error code ‘HTTP 429 - Too many requests’. The API can stop making additional requests and retry in a few seconds to get response for further requests. 

Not all Talent Intelligence API calls require the same amount of CPU time to process. Based on this variance in processing power, the API end points are mapped to different levels which determine the number of Call Units. 

 

Rate Limit Call Units by API levels: 

API Level 

Rate Limit: Call Units 

Number of Requests allowed per min 

Level 1 

120 

Level 2 

40 

Level 3 

10 

12 

 

For example, the Demand endpoint is mapped to Level 1, so an API can send up to 120 Demand call per minute (120 Call Units) successfully, whereas Hiring difficulty is mapped to Level 2, so an API client can send up to 40 calls per minute (40 API calls * 3 Call Units). API clients can also combine level 1 and level 2 APIs at any time. In such case Rate Limit will be between 40 and 120 depending how many calls of level 1 API and level 2 API requests are sent in the same minute. 

 

Service Limits 

“Service limit” refers to the annual quota of allowed API usage for each client. Depending on the API level, an API call would consume a certain amount of Call Units.  

Similarly to Rate Limits, designations of Call Units are based on their variance in processing power. The majority of Talent Intelligence APIs equate to 1 Call Unit per API call deducted from the annual quota.  

 

Call block credits consumed by API levels: 

API Level 

Service Limit: Call Units consumed 

Level 1 

Level 2 

Level 3 

10 

  

Call Units by API end point: 

Usecases 

API end point  

Level 

# Call Units 

Hiring Strategy 

DEMAND 

Hiring Strategy 

SUPPLY 

Hiring Strategy 

SALARY 

Hiring Strategy 

SUPPLY_DEMAND_RATIO 

Hiring Strategy 

COMPETITIVE_CONCENTRATION 

Hiring Strategy 

HIRING_DIFFICULTY 

Hiring Strategy 

TOP_TITLE  

Hiring Strategy 

JOB_DESCRIPTION_EXTRACTOR 

Foundational Taxonomy 

TAXONOMY_EMPLOYER 

Foundational Taxonomy 

TAXONOMY_LOCATION 

Foundational Taxonomy 

TAXONOMY_SKILL 

Foundational Taxonomy 

TAXONOMY_TITLE  

Foundational Taxonomy 

TALENTPROFILE_LIST 

Foundational Taxonomy 

TALENTPROFILE_DETAIL 

Foundational Taxonomy 

LOOKUP_EMPLOYER 

Competitive Benchmarking 

TOP_EMPLOYER 

Location Benchmarking 

TOP_LOCATION 

Skill Strategy 

TOP_SKILL