Affinda

Affinda Search and Match API

Resume search, job description search, and matching across parsed-document indexes. Score candidates against a job description (or vice versa), retrieve match details, configure search and embed parameters, and request job-title and skill suggestions. Includes index management for organizing parsed documents and embeddable UI configuration for resume and JD search components.

GitHub OpenAPI
Business capability
Talent Acquisition Management BC-300.10

Operations 24

POST /v3/documents/create_from_data Create a document from raw data #
POST /v3/documents/{identifier}/update_data Update a document's data #
GET /v3/occupation_groups List occupation groups #
POST /v3/resume_search Search through parsed resumes #
POST /v3/resume_search/details/{identifier} Get search result of specific resume #
GET /v3/resume_search/config Get the config for the logged in user's embeddable resume search tool #
PATCH /v3/resume_search/config Update the config for the logged in user's embeddable resume search tool #
POST /v3/resume_search/embed Create a signed URL for the embeddable resume search tool #
GET /v3/resume_search/match Match a single resume and job description #
GET /v3/resume_search/suggestion_job_title Get job title suggestions based on provided job title(s) #
GET /v3/resume_search/suggestion_skill Get skill suggestions based on provided skill(s) #
POST /v3/job_description_search Search through parsed job descriptions #
POST /v3/job_description_search/details/{identifier} Get search result of specific job description #
GET /v3/job_description_search/config Get the config for the logged in user's embeddable job description search tool #
PATCH /v3/job_description_search/config Update the config for the logged in user's embeddable job description search… #
POST /v3/job_description_search/embed Create a signed URL for the embeddable job description search tool #
GET /v3/index Get list of all indexes #
POST /v3/index Create a new index #
PATCH /v3/index/{name} Update an index #
DELETE /v3/index/{name} Delete an index #
GET /v3/index/{name}/documents Get indexed documents for a specific index #
POST /v3/index/{name}/documents Index a new document #
DELETE /v3/index/{name}/documents/{identifier} Delete an indexed document #
POST /v3/index/{name}/documents/{identifier}/re_index Re-index a document #

Documentation

📖
Documentation
https://docs.affinda.com/reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/affinda/refs/heads/main/openapi/affinda-search-match-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/affinda-search-match-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

affinda-search-match-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: '# Introduction

    Affinda uses the latest advancements in AI technology to rapidly process documents with better-than-human accuracy.'
  version: v3
  title: Affinda Search & Match API
  contact:
    email: contact@affinda.com
  license:
    name: MIT
    url: https://raw.githubusercontent.com/affinda/affinda-api-spec/master/LICENSE
  x-logo:
    url: https://api.affinda.com/static/documentation/affinda_logo.png
    backgroundColor: '#FFFFFF'
    altText: Affinda logo
servers:
- url: https://{region}.affinda.com
  description: 'Select the correct server for your instance: api (AUS/Global), api.us1 (US), or api.eu1 (EU).'
  variables:
    region:
      default: api
      description: The instance region. Use 'api' for AUS/Global, 'api.us1' for US, or 'api.eu1' for EU. You can find your region in the Affinda web app URL.
      enum:
      - api
      - api.eu1
      - api.us1
      x-ms-parameter-location: client
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (130 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/affinda/refs/heads/main/openapi/affinda-search-match-api-openapi.yml