Welcome to the new Affinda Docs – explore the Academy, browse guides, or ask the AI assistant any questions you have!
curl --request POST \
--url https://{region}.affinda.com/v2/job_description_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"indices": [
"all-job-descriptions"
],
"resume": "<string>",
"jobTitles": [
"<string>"
],
"jobTitlesRequired": true,
"jobTitlesWeight": 0.5,
"totalYearsExperience": 123,
"yearsExperienceRequired": true,
"yearsExperienceWeight": 0.5,
"locations": [
{
"name": "",
"coordinates": {
"latitude": 123,
"longitude": 123
},
"distance": 100,
"unit": "km"
}
],
"locationsWeight": 0.5,
"locationsRequired": true,
"skills": [
{
"name": "<string>",
"required": true
}
],
"skillsWeight": 0.5,
"languages": [
{
"name": "<string>",
"required": true
}
],
"languagesWeight": 0.5,
"degrees": [
"<string>"
],
"degreesRequired": true,
"degreeTypes": [
"bachelors"
],
"degreeTypesRequired": true,
"educationWeight": 0.5,
"searchExpression": "<string>",
"searchExpressionRequired": true,
"searchExpressionWeight": 0.5,
"socCodes": [
123
],
"socCodesWeight": 0.5,
"socCodesRequired": true,
"managementLevel": "Low",
"managementLevelRequired": true,
"managementLevelWeight": 0.5,
"customData": [
{
"filterType": "equals",
"dataPoint": "isAvailable",
"query": {
"value": true
},
"required": true,
"weight": 0.5
}
]
}'
{
"count": 130,
"next": "https://api.affinda.com/v2/search?limit=20&offset=20",
"previous": "https://api.affinda.com/v2/search?limit=20",
"parameters": {
"indices": [
"all-job-descriptions"
],
"resume": "<string>",
"jobTitles": [
"<string>"
],
"jobTitlesRequired": true,
"jobTitlesWeight": 0.5,
"totalYearsExperience": 123,
"yearsExperienceRequired": true,
"yearsExperienceWeight": 0.5,
"locations": [
{
"name": "",
"coordinates": {
"latitude": 123,
"longitude": 123
},
"distance": 100,
"unit": "km"
}
],
"locationsWeight": 0.5,
"locationsRequired": true,
"skills": [
{
"name": "<string>",
"required": true
}
],
"skillsWeight": 0.5,
"languages": [
{
"name": "<string>",
"required": true
}
],
"languagesWeight": 0.5,
"degrees": [
"<string>"
],
"degreesRequired": true,
"degreeTypes": [
"bachelors"
],
"degreeTypesRequired": true,
"educationWeight": 0.5,
"searchExpression": "<string>",
"searchExpressionRequired": true,
"searchExpressionWeight": 0.5,
"socCodes": [
123
],
"socCodesWeight": 0.5,
"socCodesRequired": true,
"managementLevel": "Low",
"managementLevelRequired": true,
"managementLevelWeight": 0.5,
"customData": [
{
"filterType": "equals",
"dataPoint": "isAvailable",
"query": {
"value": true
},
"required": true,
"weight": 0.5
}
]
},
"results": [
{
"identifier": "<string>",
"score": 0.98,
"pdf": "https://affinda-api.s3.amazonaws.com/media/documents/Example-Job-Description",
"jobTitle": {
"value": "Software Developer",
"label": "Job Title",
"score": 0.68
},
"managementLevel": {
"value": "Low",
"label": "Management level",
"score": 0.68
},
"experience": {
"value": "2.0 - 3.0 years",
"label": "Experience",
"score": 0.68
},
"skills": {
"value": "Python (Programming Language), Software Development",
"label": "Skills",
"score": 0.68
},
"languages": {
"value": "English",
"label": "Languages",
"score": 0.68
},
"location": {
"value": "Roxburgh Park, Australia",
"label": "Location",
"score": 0.68
},
"education": {
"value": "Architecture Interior Design",
"label": "Education",
"score": 0.68
},
"occupationGroup": {
"value": "Programmers and software development professionals",
"label": "Occupation group",
"score": 0.68
},
"searchExpression": {
"label": "Search expression",
"value": "<string>",
"score": 0.68
},
"organizationName": "Microsoft",
"customData": {}
}
]
}
Searches through parsed job descriptions. You can search with custom criterias or a resume.
curl --request POST \
--url https://{region}.affinda.com/v2/job_description_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"indices": [
"all-job-descriptions"
],
"resume": "<string>",
"jobTitles": [
"<string>"
],
"jobTitlesRequired": true,
"jobTitlesWeight": 0.5,
"totalYearsExperience": 123,
"yearsExperienceRequired": true,
"yearsExperienceWeight": 0.5,
"locations": [
{
"name": "",
"coordinates": {
"latitude": 123,
"longitude": 123
},
"distance": 100,
"unit": "km"
}
],
"locationsWeight": 0.5,
"locationsRequired": true,
"skills": [
{
"name": "<string>",
"required": true
}
],
"skillsWeight": 0.5,
"languages": [
{
"name": "<string>",
"required": true
}
],
"languagesWeight": 0.5,
"degrees": [
"<string>"
],
"degreesRequired": true,
"degreeTypes": [
"bachelors"
],
"degreeTypesRequired": true,
"educationWeight": 0.5,
"searchExpression": "<string>",
"searchExpressionRequired": true,
"searchExpressionWeight": 0.5,
"socCodes": [
123
],
"socCodesWeight": 0.5,
"socCodesRequired": true,
"managementLevel": "Low",
"managementLevelRequired": true,
"managementLevelWeight": 0.5,
"customData": [
{
"filterType": "equals",
"dataPoint": "isAvailable",
"query": {
"value": true
},
"required": true,
"weight": 0.5
}
]
}'
{
"count": 130,
"next": "https://api.affinda.com/v2/search?limit=20&offset=20",
"previous": "https://api.affinda.com/v2/search?limit=20",
"parameters": {
"indices": [
"all-job-descriptions"
],
"resume": "<string>",
"jobTitles": [
"<string>"
],
"jobTitlesRequired": true,
"jobTitlesWeight": 0.5,
"totalYearsExperience": 123,
"yearsExperienceRequired": true,
"yearsExperienceWeight": 0.5,
"locations": [
{
"name": "",
"coordinates": {
"latitude": 123,
"longitude": 123
},
"distance": 100,
"unit": "km"
}
],
"locationsWeight": 0.5,
"locationsRequired": true,
"skills": [
{
"name": "<string>",
"required": true
}
],
"skillsWeight": 0.5,
"languages": [
{
"name": "<string>",
"required": true
}
],
"languagesWeight": 0.5,
"degrees": [
"<string>"
],
"degreesRequired": true,
"degreeTypes": [
"bachelors"
],
"degreeTypesRequired": true,
"educationWeight": 0.5,
"searchExpression": "<string>",
"searchExpressionRequired": true,
"searchExpressionWeight": 0.5,
"socCodes": [
123
],
"socCodesWeight": 0.5,
"socCodesRequired": true,
"managementLevel": "Low",
"managementLevelRequired": true,
"managementLevelWeight": 0.5,
"customData": [
{
"filterType": "equals",
"dataPoint": "isAvailable",
"query": {
"value": true
},
"required": true,
"weight": 0.5
}
]
},
"results": [
{
"identifier": "<string>",
"score": 0.98,
"pdf": "https://affinda-api.s3.amazonaws.com/media/documents/Example-Job-Description",
"jobTitle": {
"value": "Software Developer",
"label": "Job Title",
"score": 0.68
},
"managementLevel": {
"value": "Low",
"label": "Management level",
"score": 0.68
},
"experience": {
"value": "2.0 - 3.0 years",
"label": "Experience",
"score": 0.68
},
"skills": {
"value": "Python (Programming Language), Software Development",
"label": "Skills",
"score": 0.68
},
"languages": {
"value": "English",
"label": "Languages",
"score": 0.68
},
"location": {
"value": "Roxburgh Park, Australia",
"label": "Location",
"score": 0.68
},
"education": {
"value": "Architecture Interior Design",
"label": "Education",
"score": 0.68
},
"occupationGroup": {
"value": "Programmers and software development professionals",
"label": "Occupation group",
"score": 0.68
},
"searchExpression": {
"label": "Search expression",
"value": "<string>",
"score": 0.68
},
"organizationName": "Microsoft",
"customData": {}
}
]
}
Basic authentication using an API key, e.g. {Authorization: Bearer 75z0bb4fbdf97b7e4111ff6c0015471094155f91}
.
You can find your API key within the Settings page of the Affinda web app. You can obtain an API key by signing up for a free trial.
The number of documents to skip before starting to collect the result set.
x >= 0
0
The numbers of results to return.
1 <= x <= 100
20
Search parameters
The body is of type object
.
Will return matching documents
The response is of type object
.