---
title: "API: Getting Started"
slug: "api-getting-started"
updated: 2025-07-30T19:19:58Z
published: 2025-07-30T19:19:58Z
canonical: "help.talenteria.com/api-getting-started"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.talenteria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API: Getting Started

# 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:**

```json
{  "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:**

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

## Example: Posting a Job

**POST** `/api/v1/jobs`

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

```json
{
  "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:** [API Reference](https://cdn.document360.io/ae8040b0-f92a-4262-a61d-9d836fcbb559/Images/Documentation/apiendpoints.min.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.