Overview of Affinda's Recruitment AI Suite

This page contains information about all the Affinda Recruitment Products

📘

The following guide is intended for customers using Affinda's Recruitment Product suite including our Resume Parser, Job Description Parser, Search & Match and Resume Redactor

For customers looking at automate other document types, please see our Platform Product Guide.

Overview of Affinda Recruitment AI suite

Affinda Recruitment AI product suite covers four complimentary products. These products leverage our core technology and the data extracted from the Resume Parser to deliver time-saving products to the recruitment industry.

Product Specific Guides

  1. Resume Parser Guide
  2. Search & Match Guide
  3. Job Description Parser Guide
  4. Resume Redactor Guide

Onboarding with Affinda

Creating your Free Trial

To create an account, navigate to the registration page at https://app.affinda.com/. After creating your account, you will be given instant free trial access to the application. This free trial includes 200 free credits that expire after 30 days.

Workspace & Collection Configuration

After first creating your free trial account at https://app.affinda.com/, you will be prompted to create a Workspace. A Workspace is where documents are processed and can contain one or many collections of documents. Select the relevant document types to start processing your use case: Resume Parser, Job Descriptions and/or Resume Redactor.

If a Resume or Job Description Parser is created, the ability to test the Affinda Search & Match UI will also be created within the left-hand panel under 'Tools'.

Managing team members

As an optional step, you can manage users in your Organisation by adding or removing them. Users can be assigned either Admin rights, which allow full access to manage settings, the workspace, and invite members, or Member rights, which permit only uploading and reviewing documents.

  • To add a user: Go to your Organisation's home page, click Members , Invite Member, enter the user’s email, select their access level, and click Invite. The user will receive an email prompting them to log in or create an account to join
  • To remove a user:Click the "X" next to their email in the Members list to remove them
    • Note: to remove other users with Admin rights , first change their role to Member before the X appears.

If your Organisation has multiple workspaces and want to restrict workspace access to specific members, you can set workspace-level permissions. To make a workspace private, Click into the relevant workspace, go to Settings > Visibility Settings, set Visibility to Private, and add the relevant organization members. Note: Only organization members can be added to private workspaces.

Integration Guide

Authentication token

Affinda's API users basic authentication using API keys. Each Affinda user will have their own API keys to manage within their user profile settings

Each API key is only viewable once when created for security purposes. As a result, users should ensure that they copy their API keys and store them in a safe location within their own environment.

📘

API keys can always be revoked and re-generated if a user fails to copy their initial key

Key rotation

Users can manage API keys effectively via the rotation capabilities offered through the web app.

  • Viewing the key: Once you create a key, you can only view it once within your user settings page in the application. It is crucial that you copy and store it in a safe location within your environment.
  • Maximum of 3 API keys: You can generate a maximum of three API keys within the Affinda app.
  • Naming and Expiry: Each API key can be named and set with an expiry date or to never expire, based on your requirements.

Processing Resumes/Job Descriptions

  • Document Upload via API: Documents can be uploaded to Affinda by sending a request to the POST documents endpoint. Each new document upload will consume one credit. Upon successful upload, the API response will include a unique document identifier (e.g., "document": "EfHgjcsD").
  • Retrieve document after initial parsing: To retrieve the results of a previously processed document, clients can use the Get Document endpoint. Retrieving results from this endpoint does not consume any credits.

There are a number of decisions for customers when uploading a document via API

AreaDescription
DocumentEither a file or URL needs to be included in the POST request.
The following formats are supported: PDF, ZIP, DOC, DOCX,XLS, XLSX, ODT, RTF, TXT, HTML, PNG, JPG, TIFF, JPEG- Volume Limits: There is no limit to the number of documents you can submit to the Affinda API. However, you will be limited to 30 documents per minute that will be processed by our high priority queue. If you would like to specify which queue to use, you can set the lowPriority parameter during document submission. Note that if you explicitly set lowPriority to false, and if you have exceeded the high priority queue rate limit, you will receive a 429 (Too Many Requests) response.

- Page Limits: The default page limit for all customers is 10 pages. Settings may be adjusted to increase this limit on a case-by-case basis. Please get in contact with your Affinda account manager for details or submit a request via our contact form .
Workspace or CollectionSpecify Collection ID instead of Workspace ID:Customers using our Resume or Job Description Parser will typically know what type of document has been received. As a result, we recommend specifying the relevant Collection identifier (as opposed to the Workspace identifier which may then result in document classification being used to route the document to the right model.
Find Workspace ID: Log in to your Affinda application and go to Workspace > Settings to find your Workspace ID. Important note: Each organisation has a maximum limit of 100 workspaces. If you anticipate exceeding this limit, please contact your Affinda account manager for assistance or submit a request through our contact form.
Find Collection ID: Hover over the collection, click the gear icon in the collection settings, and the Collection ID will be displayed.
Synchronous or Asynchronous ResponsesWithin the request, customers can set waitto true / false depending if the parsing response needs to be returned synchronously or not. For customers who are bulk uploading, it is recommended to set waitto false.

- Synchronous - If "true" (default), will return a response only after processing has been completed.
- Asynchronous - If "false", will return the document identifier and other metadata alongside an empty data object. The data object can be returned at a later date by either:
- Polling GET endpoint until processing is complete; or
- Setting up webhooks to get a notification that parsing has completed and then using the GET endpoint to pull the extracted data
Parsing TimeFor customers who need real-time responses where seconds count, please set parameters to the following when submitting a document:

- enableValidationTool: False
- deleteAfterParse: True
- compact: True By setting these parameters, Affinda can bypass the need to save any data to our database, which eliminates unnecessary processing time and reduces the overall time taken to return results. However, note that this means that:
- The document can not be viewed in the Affinda app(e.g. for 'human in the loop' validation)
- The document is not retained in our system so responses can not be fetched at a later date
- Field metadata is not returned, only the 'parsed' value

Integration through a third-party

Affinda is now available on Zapier, making it simpler to integrate our document processing solution with your favorite apps. Learn how to automate your document workflows using Affinda and Zapier HERE

Information Security

Product overview

Affinda is ISO27001 certified, reflecting our commitment to rigorous, best-in-class information security practices and robust risk management protocols. All our products are designed with privacy, security, and compliance as core principles.

  • Resume and Job Description Parsers: Affinda’s parsers convert unstructured resumes and job descriptions into structured data, enabling faster, more informed decisions for HR and recruiters. Unlike generative AI services, Affinda is an extractive AI solution. Our proprietary technology extracts data from documents, reducing risks commonly associated with generative AI, such as copyright infringement and bias risks. We do not use large language models like GPT and ensure data privacy by not using client documents to train our models.
  • Search and Match: Affinda’s search algorithm delivers precise, relevant results based solely on user-defined criteria. No AI is employed, ensuring full control and transparency in the decision-making process.
  • Resume Redactor: Our Resume Redactor, powered by the same proprietary AI technology as our Resume Parser, redacts sensitive information from resumes. We also offer an LLM Redactor for enhanced accuracy and expanded field coverage, adhering to the same stringent security standards.

On-Premise Deployment

Most customers benefit from Affinda's technology through our hosted solution. However, some may require a locally deployed solution for specific needs. To support these users, we’ve published an Affinda Self-Hosted Deployment Guide

If you’re interested in a local deployment, please contact your Affinda account manager for further details or submit a request via our contact form.

Document Lifecycle

The Affinda API provides customers full control over the lifecycle of their submitted documents.

Lifecycle options can be set per document and include:

Deletion
When a document is deleted, the document and all associated files are immediately removed from our servers. All access to the document will be lost. Document metadata, which may include file names but does not include the file content, may remain in Affinda’s database or backups of Affinda’s database for some time.

Expiration
A typical scenario when incorporating the API into a web app is to enable a customer’s end users to perform document parses on demand. In such cases, it is not necessary or desirable to store the result indefinitely. To facilitate this, the API allows a customer to specify an expiry time when they submit the document. When a document has an expiration set, it will be deleted automatically at the expiration date.

Offboarding

  • User Offboarding: When a user is removed from an organisation, they are automatically offboarded and will no longer have access to any data within the organisation
  • Delete Organisation: An organization can be deleted either via API or through the Affinda app by navigating to: Organization > Settings > "Delete [Organization Name]".