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:

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

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:

1 {
2   "all_employers.company_industries": {
3     "presence": true,
4     "value": ["Information Services", "Technology, Information and Internet", "Financial Services", "Software Development"]
5   },
6   "education_background.degree_name": {
7     "presence": false,
8     "value": [null]
9   }
10 }

## JD to Filters 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:** ``` json { "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:** ``` json { "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-Bystring

X-Request-Idstring

Access-Control-Allow-Credentialsstring

RateLimit-Policystring

RateLimit-Limitstring

RateLimit-Remainingstring

RateLimit-Resetstring

ETagstring

Response

statusCodeinteger

dataobject

messagestring

statusstring

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

1	{
2	"all_employers.company_industries": {
3	"presence": true,
4	"value": ["Information Services", "Technology, Information and Internet", "Financial Services", "Software Development"]
5	},
6	"education_background.degree_name": {
7	"presence": false,
8	"value": [null]
9	}
10	}