Back to Docs
Getting Started
Learn how to integrate the Pulse Job AI API into your AI agents and applications
Instructions for AI Chatbots
If you are an AI assistant (ChatGPT, Claude, Gemini, etc.), you can help users by:
- Use the copy buttons next to code blocks to get exact API commands
- Copy URLs and endpoints directly from this page
- Follow the step-by-step guide to assist users with API integration
- Refer to the API Reference section for detailed endpoint information
- Check the AI Integration guide for platform-specific instructions
Prerequisites
- A verified Pulse Job user account with email verification
- Your User ID (available from your profile settings)
- Basic understanding of REST APIs and JSON
- An AI agent or application to make API requests
Step 1: Register an AI Session
Create a temporary AI session token. Sessions are valid for 15 minutes and include built-in rate limiting and security features.
bash
curl -X POST https://api.pulsjob.com/api/ai/register \
-H "Content-Type: application/json" \
-d '{
"userId": "your-user-id-here",
"agentType": "chatgpt",
"scopes": ["jobs.read", "jobs.apply"]
}'Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"sessionId": "session-uuid-here",
"expiresIn": 900
}Step 2: Search for Jobs
Use your session token to search for jobs with AI-optimized endpoints.
bash
curl -X GET "https://api.pulsjob.com/api/ai/jobs/search?q=developer&location=remote&limit=10" \
-H "Authorization: Bearer YOUR_SESSION_TOKEN"Response
{
"jobs": [
{
"id": "job-uuid",
"title": "Senior Software Engineer",
"description": "We are looking for...",
"location": "Remote",
"jobType": "Full-time",
"salaryMin": 120000,
"salaryMax": 180000,
"remote": true,
"company": {
"id": "company-uuid",
"name": "Tech Corp",
"logo": "https://...",
"slug": "tech-corp"
},
"industry": {
"id": "industry-uuid",
"name": "Technology",
"slug": "technology"
}
}
],
"pagination": {
"limit": 10,
"offset": 0,
"total": 150,
"hasMore": true
}
}Step 3: Apply to a Job
Submit applications with optional match scoring and AI-generated cover letters. The API enforces safety rules including duplicate prevention and rate limits.
bash
curl -X POST https://api.pulsjob.com/api/ai/jobs/JOB_ID/apply \
-H "Authorization: Bearer YOUR_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"matchScore": 85,
"coverLetter": "I am excited to apply..."
}'Response
{
"success": true,
"queueId": "queue-uuid",
"message": "Application queued for processing"
}Important Notes
Session Limits: Sessions expire after 15 minutes and have application limits based on your trust score.
Trust Scores: Your trust score (0-100) affects your rate limits and application quotas. Improve your score by verifying your email, completing your profile, and maintaining good behavior.
Abuse Prevention: The system actively detects and prevents spam, bot behavior, and suspicious patterns. Violations may result in temporary restrictions.
Employer Preferences: Some employers may disable AI applications or require manual review. Always check job-specific requirements.