GuidesAPI EndpointsAPI Changelog
Live AI Demo
API Endpoints

🧠 Tag a Text

Predict most likely tags for a text with our library of AI algorithms.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

Prerequisites

  1. ✨ Create a Workspace
  2. 🔑 Get your API Key
  3. 🧠 Activate Text Tagging API
🚧

Batch Mode with 'texts' parameter

  • Batch size = lenght(texts) should be < 32 (and a multiple of 2 for an optimum speed).

10 taggers have been released through the Tagging API. We are actively working on bringing out more taggers. Here is a list of all the currently available taggers:

Algorithm KeyTaxonomyTaxonomy IdsTaxonomy SizeLanguagesUse Case
tagger-rome4-family2-largeGrand domaines of job the French ROME 4.0ROME 4.0 Grand domaines codes1443 languages*High-accuracy classification into broad job families
tagger-rome4-subfamily2-largeDomaines of job the French ROME 4.0ROME 4.0 Domaines codes11043 languages*High-accuracy classification into job sub-families
tagger-rome4-category2-largeMetiers of job the French ROME 4.0ROME 4.0 Metiers codes105643 languages*High-accuracy classification into job categories
tagger-rome4-jobtitle2-largeAppellations of job the French ROME 4.0ROME 4.0 OGR codes1210743 languages*High-accuracy classification into specific job titles
tagger-rome4-family2Grand domaines of job the French ROME 4.0ROME 4.0 Grand domaines codes1443 languages*Fast classification into broad job families
tagger-rome4-subfamily2Domaines of job the French ROME 4.0ROME 4.0 Domaines codes11043 languages*Fast classification into job sub-families
tagger-rome4-category2Metiers of job the French ROME 4.0ROME 4.0 Metiers codes105643 languages*Fast classification into job categories
tagger-rome4-jobtitle2Appellations of job the French ROME 4.0ROME 4.0 OGR codes1210743 languages*Fast classification into specific job titles
tagger-hrflow-degree2-largeHrFlow.ai Education DegreesIdentifiers defined by HrFlow.ai643 languages*High-accuracy classification into standard degrees
tagger-hrflow-seniority2-largeHrFlow.ai Seniority LevelsIdentifiers defined by HrFlow.ai543 languages*High-accuracy classification into standard seniority levels
tagger-hrflow-contract2-largeHrFlow.ai Contract TypesIdentifiers defined by HrFlow.ai543 languages*High-accuracy classification into standard contract types
tagger-hrflow-skills2-largeHrFlow.ai Hard Skills and Soft SkillsIdentifiers defined by HrFlow.ai422743 languages*High-accuracy classification into most frequently used skills in HR.
tagger-hrflow-degreeHrFlow.ai Education DegreesIdentifiers defined by HrFlow.ai743 languages*Fast classification into standard degrees
tagger-hrflow-seniorityHrFlow.ai Seniority LevelsIdentifiers defined by HrFlow.ai643 languages*Fast classification into standard seniority levels
tagger-hrflow-contractHrFlow.ai Contract TypesIdentifiers defined by HrFlow.ai643 languages*Fast classification into standard contract types
tagger-hrflow-skillsHrFlow.ai Hard Skills and Soft SkillsIdentifiers defined by HrFlow.ai5000FR,ENFast classification into most frequently used skills in HR.
tagger-hrflow-dynamicCustom Taxonomy (< 32 labels)Identifiers defined by HrFlow.aiN/A43 languages*High-accuracy classification into custom taxonomy.

Request headers

FieldValue
Content-Typeapplication/json
X-API-KEYYour API Key.
X-USER-EMAILYour HrFlow.ai account's email.
📘

Response JSON

The Response contains a list of predicted tags and their likelihood.

Body Params
string
enum
required
Defaults to tagger-rome4-family2-large

AI tagging algorithm you want to apply to the input text.

texts
array of strings
required
Defaults to Data Insights Corp. is seeking a Senior Data Scientist for a contract-to-direct position. You will be responsible for designing and implementing advanced machine learning algorithms and playing a key role in shaping our data science initiatives. The CDI arrangement offers a pathway to a full-time role,DataTech Solutions is hiring a Data Scientist for a fixed-term contract of 12 months. You will work on various data analysis and modeling projects and assisting in short-term projects; with the possibility of extension or permanent roles

Tag a list of texts. Each text can be: the full text of a Job, a Resume, a Profile, an experience, a Job and more. Maximum length is 32.

texts*
int32
Defaults to 1

Number of predicted tags that will be returned.

string
enum
Defaults to en

Language of the returned tags.

Allowed:
string

A context for given labels if algorithm_key="tagger-hrflow-labels".

dynamic_labels
array of strings
Defaults to CDI,CDD

List of output tags if algorithm_key ="tagger-hrflow-labels".

dynamic_labels
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json