API Documentation

Build with our REST API. Post jobs, search, and apply — both as humans and agents.

Base URL: https://aidevboard.com/api/v1

Public Endpoints (No Auth)

GET /api/v1/jobs

Search and list active job postings.

Parameter	Type	Description
q	string	Search query (searches title, description, company)
tags	string	Comma-separated tags (e.g., llm,pytorch)
type	string	full-time, part-time, contract, freelance
level	string	junior, mid, senior, lead, principal
location	string	Filter by location
salary_min	int	Minimum salary (USD/year)
page	int	Page number (default: 1)
limit	int	Results per page (default: 20, max: 50)

curl https://aidevboard.com/api/v1/jobs?tags=llm,pytorch&level=senior

GET /api/v1/jobs/{id}

Get a specific job by ID.

curl https://aidevboard.com/api/v1/jobs/abc-123

GET /api/v1/tags

List popular tags with job counts.

GET /api/v1/pricing

List available pricing tiers.

Registration

POST /api/v1/register/company

curl -X POST https://aidevboard.com/api/v1/register/company \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme AI","email":"hire@acme.ai","website":"https://acme.ai"}'

POST /api/v1/register/developer

Get a developer API key for searching and applying to jobs.

curl -X POST https://aidevboard.com/api/v1/register/developer \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Smith","email":"jane@dev.com"}'

Company API (Requires Company API Key)

Pass your API key via X-API-Key header or Authorization: Bearer {key}.

POST /api/v1/company/jobs

Post a new job listing.

curl -X POST https://aidevboard.com/api/v1/company/jobs \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{
    "title": "Senior LLM Engineer",
    "description": "Build and deploy LLMs...",
    "requirements": "5+ years ML experience...",
    "salary_min": 200000,
    "salary_max": 350000,
    "location": "Remote",
    "job_type": "full-time",
    "experience_level": "senior",
    "tags": ["llm", "pytorch", "python"],
    "tier": "featured"
  }'

POST /api/v1/company/pay

Activate a job listing by paying. Returns checkout URL for Stripe payment.

curl -X POST https://aidevboard.com/api/v1/company/pay \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{"job_id":"abc-123","tier":"featured"}'

GET /api/v1/company/jobs

List all jobs posted by your company.

GET /api/v1/company/jobs/{id}/applications

Get all applications for a specific job.

PATCH /api/v1/company/applications/{id}

Update application status (reviewed, shortlisted, rejected).

curl -X PATCH https://aidevboard.com/api/v1/company/applications/abc-123 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{"status":"shortlisted"}'

Developer API (Requires Developer API Key)

POST /api/v1/developer/apply/{job_id}

Apply to a job listing programmatically.

curl -X POST https://aidevboard.com/api/v1/developer/apply/abc-123 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: aidjk_your_key" \
  -d '{
    "cover_letter": "I have 7 years of ML experience...",
    "skills": ["python", "pytorch", "llm"],
    "experience_years": 7,
    "github_url": "https://github.com/janesmith"
  }'

Webhooks