peviitor API

Platformă de descoperire a joburilor — documentație API publică

https://api.peviitor.ro

GET /v1/random/ Get a random job listing ▶

Returns a single random job from the Solr job index. Useful for discovery widgets, "job of the day" features, or testing integrations.

How it works

Queries Solr for the total number of indexed jobs
Picks a random offset between 0 and total count
Fetches exactly one document at that offset
Returns the job mapped to the peviitor Job Model Schema

Try it

curl

curl -X GET "https://api.peviitor.ro/v1/random/" \
  -H "Accept: application/json"

Response fields

Field	Type	Description
title	string	Exact job position title
company	string	Hiring company name (uppercase)
location	string[]	Array of cities or addresses
workmode	string	`remote`, `on-site`, or `hybrid`
url	string	Full URL to the job detail page (unique key)
salary	string	Salary interval with currency, e.g. `5000-8000 RON`
tags	string[]	Skill tags (lowercase, max 20)
cif	string	CIF/CUI of the company
date	string	ISO8601 UTC timestamp of indexing
status	string	`scraped`, `tested`, `published`, or `verified`

200 — Success

{
  "title": "Inginer IT",
  "company": "COMPANY SRL",
  "location": ["Bucure\u0219ti", "Cluj-Napoca"],
  "workmode": "remote",
  "url": "https://example.com/job/123",
  "salary": "5000-8000 RON",
  "tags": ["python", "java"],
  "cif": "12345678",
  "date": "2026-06-15T10:00:00Z",
  "status": "published"
}

404 — No Jobs Found

{
  "error": "No jobs found"
}

503 — Service Unavailable

{
  "error": "Job core unavailable",
  "details": "PROD_SERVER not set"
}

Requirements — Random

Item	Details
Method	`GET` only
Auth	None (public endpoint)
Params	None
Content-Type	`application/json`

Status codes

200A random job was found and returned successfully
404No jobs are currently indexed in the Solr core
503Solr core is unavailable or environment not configured

DELETE /v1/empty/ Delete all job records ▶

Permanently deletes every job document from the job Solr core. In production, requires valid API credentials.

Authentication

In production mode (NODE_ENV=production), you must provide X-API-Key and X-Cleanup-Secret headers matching api.env. In any other environment (test, dev, staging, etc.), these headers are not checked and any value is accepted.

Request headers

Header	Required	Description
X-API-Key	Production only	API key from `CLEANUP_API_KEY` in api.env
X-Cleanup-Secret	Production only	Secret from `CLEANUP_SECRET` in api.env
Content-Type	Yes	`application/json`

Request body

{
  "confirmation": "DELETE_ALL_DATA"
}

Try it

curl — production

curl -X DELETE "https://api.peviitor.ro/v1/empty/" \
  -H "X-API-Key: abc123xyz789" \
  -H "X-Cleanup-Secret: secret456def012" \
  -H "Content-Type: application/json" \
  -d '{"confirmation": "DELETE_ALL_DATA"}'

curl — test / dev

curl -X DELETE "https://test.peviitor.ro/api/v1/empty/" \
  -H "Content-Type: application/json" \
  -d '{"confirmation": "DELETE_ALL_DATA"}'

200 — Jobs Deleted

{
  "message": "Jobs deleted successfully",
  "jobsDeleted": 42,
  "companiesDeleted": 10
}

401 — Unauthorized

{
  "error": "Unauthorized - invalid credentials"
}

405 — Method Not Allowed

{
  "error": "Only DELETE method allowed"
}

503 — Service Unavailable

{
  "error": "Job core unavailable",
  "details": "PROD_SERVER not set"
}

Requirements — Empty

Item	Details
Method	`DELETE` only
Auth	`X-API-Key` + `X-Cleanup-Secret` (production only)
Params	Body: `{"confirmation": "DELETE_ALL_DATA"}`
Content-Type	`application/json`

Status codes

200All jobs were deleted successfully
401Invalid or missing credentials (production only)
405Only DELETE method is allowed
503Solr core is unavailable or environment not configured