Talenteria API: Getting Started

Talenteria’s RESTful API allows you to seamlessly integrate your existing HR systems — such as Applicant Tracking Systems (ATS), Human Resource Information Systems (HRIS), or job boards — with Talenteria’s powerful recruitment and career site platform.

Whether you're importing job postings, syncing candidate data, or pushing screening results back into your system, the Talenteria API gives you the flexibility and control you need to build custom workflows that fit your hiring process.

What You Can Do with the Talenteria API

• Read and Post Jobs Programmatically
  Create and update job openings from your ATS or HR system to Talenteria automatically.

• Create and Retrieve Candidate Applications
  Pull candidate data, including resumes and screening responses, directly into your external systems for further processing.

• Manage Talent Pools and Create Talent Pool Applications
  Build and manage AI-powered talent pools by pushing or pulling candidate profiles between Talenteria and your internal databases.

Base URL

All requests should be made to the base URL of your Talenteria instance:

https://your_instance_prefix.talenteria.online

Authentication

Talenteria uses secure token-based authentication. You must call the authentication method:

/api/v1/auth

Example Value:

{  "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "clientSecret": "string"}

You can obtain your API key from the Talenteria Support Team. Make sure to store it securely.

Example Response:

{
    "token": "TTT_TOKEN_TTT",
    "isSuccessfull": true,
    "httpResponseCode": 200
}

Example: Posting a Job

POST /api/v1/jobs

curl -X 'POST' \
  'https://your_instance_prefix.talenteria.online/api/v1/jobs' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer TTT_TOKEN_TTT '

{
  "externalId": "string",
  "status": "string",
  "category": "string",
  "client": "string",
  "title": "string",
  "employmentType": "string",
  "referenceNumber": "string",
  "department": "string",
  "location": {
    "country": "string",
    "region": "string",
    "city": "string",
    "streetAddress": "string",
    "postalCode": "string"
  },
  "salary": {
    "currency": "string",
    "value": 0,
    "frequency": "string"
  },
  "description": "string",
  "responsibilities": "string",
  "requirements": "string",
  "benefits": "string",
  "dueDate": "2025-03-26T00:04:50.274Z"
}

Rate Limits

The Talenteria API enforces rate limits to ensure fair usage. If you exceed the limit, you will receive a 429 Too Many Requests response. Contact support if you need to increase your quota for large-scale integrations.

Need Help?

API Documentation: https://demoset.talenteria.online/swagger/index.html

Support: Reach out to our integration support team via the Help Center or email.

Custom Integrations: Our team can help design and implement custom solutions for enterprise clients — just get in touch.