tarta-api/README.md

A JavaScript wrapper for the Tarta API, enabling seamless AI-powered job search integration for Node.js and browser-based projects.

# TartaAPI-JS

## Overview
TartaAPI-JS is a JavaScript wrapper for the Tarta API, designed to seamlessly integrate AI-powered job search functionality into your Node.js applications or browser-based JavaScript projects.

## API Documentation
For detailed API documentation, visit:  
[Tarta API Documentation](https://api.tarta.ai/swagger/index.html)

## What is Tarta?
Tarta.ai is a sophisticated AI platform that consolidates job listings from a wide range of sources, including job boards and social media. The platform streamlines the job search experience, matching users with suitable vacancies and even facilitating interview scheduling.

To learn more, visit:  
[Tarta Official Website](https://tarta.ai/)

## ChatGPT Integration
Tarta is also available as a ChatGPT plugin to enhance your job search experience:  
[Tarta ChatGPT Plugin](https://chat.openai.com/g/g-Gkf9YM4sR-job-search-in-the-us)

## Installation
To install TartaAPI via npm, use the following command:
```sh
npm install tarta-api
```

## Usage Example
Here's a simple example demonstrating how to use the library to execute a job search:

```javascript
const { JobSearchService } = require('tarta-api');

function searchJobs(title, size = 5) {
    const request = { title: title, size: size };

    JobSearchService.searchJobsAsync(request)
        .then(results => {
            const jobs = results.jobs || [];

            if (jobs.length === 0) {
                console.log("No job results found.");
                return;
            }

            console.log("Job Search Results:");
            jobs.forEach(job => {
                const jobName = job.name || "N/A";
                const company = job.companyName || "N/A";
                const location = job.location || {};
                const city = location.city || "Unknown";
                const state = location.state || "Unknown";
                const country = location.country || "Unknown";
                const source = job.feed || "N/A";
                const postedDate = job.created || "N/A";

                console.log(`Job: ${jobName} at ${company}`);
                console.log(`Location: ${city}, ${state}, ${country}`);
                console.log(`Source: ${source}`);
                console.log(`Posted: ${postedDate}\n`);
            });
        })
        .catch(error => {
            console.error(`Error fetching job results: ${error}`);
        });
}

searchJobs("javascript", 2);
```

## Key Features
- **Effortless API Integration**: Interact with Tarta's API using straightforward JavaScript methods.
- **AI Matching**: Utilize AI algorithms to find jobs that align with user profiles and preferences.
- **Interview Scheduling**: Automate interview scheduling to streamline the application process.

## Contributions
Contributions are welcome! Feel free to open issues or submit pull requests to enhance the library.

## License
This project is under the MIT License.

---
Experience the efficiency of Tarta and integrate AI-powered job search into your JavaScript applications today!