JD to Filters

curl -X POST https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session/get-annotation \
     -H "x-fj-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "userText": "Looking for a .NET Developer with 3–7 years of experience in building scalable backend systems, preferably in the fintech domain. The role involves developing APIs and microservices using C#, .NET Core, SQL Server, and cloud technologies while ensuring high performance, security, and reliability of financial applications.",
  "linkedin_profile_url": ""
}'

{
  "statusCode": 200,
  "data": {
    "all_employers.company_industries": {
      "presence": true,
      "value": [
        "Information Services",
        "Technology, Information and Internet",
        "Technology, Information and Media",
        "Financial Services",
        "Software Development",
        "IT System Custom Software Development",
        "Design Services",
        "Desktop Computing Software Products",
        "Mobile Computing Software Products",
        "Internet Publishing"
      ]
    },
    "education_background.degree_name": {
      "presence": false,
      "value": [
        null
      ]
    },
    "education_background.field_of_study": {
      "presence": false,
      "value": []
    },
    "years_of_experience_raw": {
      "presence": true,
      "value": [
        3,
        7
      ]
    },
    "current_employers.title": {
      "presence": true,
      "value": [
        ".NET Developer",
        "C# Developer",
        "Backend Developer",
        "Software Engineer",
        "Fintech Developer",
        "API Developer"
      ]
    },
    "region": {
      "presence": false,
      "value": []
    },
    "country_region": {
      "presence": false,
      "value": [
        "India"
      ]
    },
    "skills": {
      "presence": true,
      "value": {
        "mandatory": [
          "C#",
          ".NET Core"
        ],
        "core": [
          "SQL Server",
          "Cloud Technologies"
        ],
        "secondary": []
      }
    }
  },
  "message": "Gemini response appended with LinkedIn fields.",
  "status": "SUCCESS"
}

Analyzes a job description (JD) text and extracts structured sourcing filters (annotations) that can be used to search and match candidate profiles.

Request

Method: POST
URL: {{BASE_URL}}/api/v1/wl/sourcing-session/get-annotation

Headers

Key	Value
`Authorization`	`{{FJ_API_KEY}}`
`Content-Type`	`application/json`

Request Body

Sent as raw JSON.

Field	Type	Required	Description
`userText`	`string`	Yes	The full job description text to be analyzed. The API parses this to extract relevant sourcing filters such as industry, skills, experience level, and education.
`linkedin_profile_url`	`string`	No	Optional LinkedIn profile URL. Can be provided to further refine or contextualize the annotation. Pass an empty string if not applicable.

Example Body:

{
  "userText": "Looking for a .NET Developer with 3–7 years of experience in building scalable backend systems, preferably in the fintech domain...",
  "linkedin_profile_url": ""
}

Response

Status: 200 OK

Returns a JSON object where each key represents a candidate profile field (e.g., all_employers.company_industries, education_background.degree_name). Each field contains:

Property	Type	Description
`presence`	`boolean`	Indicates whether this filter should be actively applied when sourcing candidates.
`value`	`array`	The extracted values for this filter. May contain `null` if no relevant value was found.

Example Response:

{
  "all_employers.company_industries": {
    "presence": true,
    "value": ["Information Services", "Technology, Information and Internet", "Financial Services", "Software Development"]
  },
  "education_background.degree_name": {
    "presence": false,
    "value": [null]
  }
}

Authentication

x-fj-api-keystring

API Key authentication via header

Request

This endpoint expects an object.

userTextstringRequired

linkedin_profile_urlstringRequired

Response headers

X-Powered-BystringOptional

X-Request-IdstringOptional

Access-Control-Allow-CredentialsstringOptional

RateLimit-PolicystringOptional

RateLimit-LimitstringOptional

RateLimit-RemainingstringOptional

RateLimit-ResetstringOptional

ETagstringOptional

Response

statusCodeinteger

dataobject

messagestring

statusstring