Semantic Search API

Performs a semantic search on resumes or jobs using a natural language query with optional filters for precision.

Sample Request & Response

POST

/v1/search/semantic

Sample Request

Headers:

{
  "Authorization": "Bearer <YOUR_API_KEY>",
  "Content-Type": "application/json"
}

Body:

{
  "query": "Looking for frontend developers with React and TypeScript",
  "target": "resumes",
  "filters": {
    "location": "Canada",
    "remote": true,
    "seniority": "mid"
  },
  "topK": 10
}

Sample Response (200)

{
  "results": [
    {
      "id": "resume_123",
      "score": 0.94,
      "metadata": {
        "name": "Jane Doe",
        "title": "Frontend Developer",
        "location": "Toronto, Canada",
        "skills": [
          "React",
          "TypeScript",
          "CSS"
        ]
      }
    },
    {
      "id": "resume_456",
      "score": 0.91,
      "metadata": {
        "name": "John Smith",
        "title": "Full Stack Developer",
        "location": "Vancouver, Canada",
        "skills": [
          "React",
          "Node.js",
          "GraphQL"
        ]
      }
    }
  ]
}