Extract criteria

POST

api

intake

Extract criteria

curl --request POST \
  --url https://api.revcenter.ai/api/intake \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "rawInput": "Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25.",
  "mode": "candidate"
}
'

const options = {
  method: 'POST',
  headers: {cookie: 'session=', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    rawInput: 'Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25.',
    mode: 'candidate'
  })
};

fetch('https://api.revcenter.ai/api/intake', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revcenter.ai/api/intake"

payload = {
    "rawInput": "Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25.",
    "mode": "candidate"
}
headers = {
    "cookie": "session=",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "criteria": {
    "family": "<string>",
    "title_variants": [
      "<string>"
    ],
    "seniority": "c_suite",
    "allowed_seniority": [
      "c_suite"
    ],
    "must_have": [
      "<string>"
    ],
    "industries": [
      "<string>"
    ],
    "metro": "San Jose, CA",
    "geo_radius_mi": 123,
    "remote_ok": true,
    "exclude_titles": [
      "<string>"
    ],
    "exclude_industries": [
      "<string>"
    ],
    "exclude_companies": [
      "<string>"
    ],
    "avoid_titles": [
      "<string>"
    ],
    "avoid_industries": [
      "<string>"
    ],
    "avoid_companies": [
      "<string>"
    ],
    "comp_band": [
      123
    ],
    "years_experience": {
      "min": 123,
      "max": 123
    },
    "min_avg_tenure_years": 123,
    "skills": [
      "<string>"
    ],
    "skills_required": [
      "<string>"
    ],
    "languages_required": [
      "<string>"
    ],
    "target_company_profile": {
      "sector": "<string>",
      "employee_range": [
        123
      ],
      "pe_backed_preferred": true
    },
    "rubric_weights": {
      "title": 123,
      "years": 123,
      "skills": 123,
      "geo": 123,
      "industry": 123,
      "seniority": 123
    }
  },
  "entityCoverage": {},
  "familyUnresolved": true,
  "familySuggestions": [
    "<string>"
  ],
  "ontologyPlan": {},
  "rawToolInput": {}
}

Authorizations

session

string

required

A signed-in workspace session, sent as a browser cookie. Requests must include credentials, and act on the session's active workspace.

Body

application/json

rawInput

string

required

The job description or brief.

Example:

"Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25."

mode

enum<string>

default:candidate

candidate searches for people against a role. client discovers target companies first, then their decision-makers.

Available options:

candidate,

client

model

enum<string>

Which model extracts criteria. Anything outside this allowlist is rejected. Omit to use the workspace default.

Available options:

claude-haiku-4-5,

claude-sonnet-5,

claude-opus-5

Response

Structured criteria plus coverage diagnostics.

criteria

object

The structured brief a search runs on. Every field is optional, but a search with no signal finds nothing useful.

The distinction that matters: exclude_* fields are hard and disqualify, while avoid_* fields are soft and only rank down. A great person at a firm you'd rather avoid still shows up; a person at an excluded firm never does.

Show child attributes

entityCoverage

object

Which criteria dimensions the input actually pinned down — drives the confirmation chips in the app.

familyUnresolved

boolean

True when the role sits outside the known role-family taxonomy. The role name is preserved as a title variant.

familySuggestions

string[]

ontologyPlan

object | null

rawToolInput

object

Extract criteria

curl --request POST \
  --url https://api.revcenter.ai/api/intake \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "rawInput": "Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25.",
  "mode": "candidate"
}
'

const options = {
  method: 'POST',
  headers: {cookie: 'session=', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    rawInput: 'Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25.',
    mode: 'candidate'
  })
};

fetch('https://api.revcenter.ai/api/intake', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revcenter.ai/api/intake"

payload = {
    "rawInput": "Clinic manager in Lévis, Québec. French required. 5+ years managing a multi-site clinic. Find 25.",
    "mode": "candidate"
}
headers = {
    "cookie": "session=",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "criteria": {
    "family": "<string>",
    "title_variants": [
      "<string>"
    ],
    "seniority": "c_suite",
    "allowed_seniority": [
      "c_suite"
    ],
    "must_have": [
      "<string>"
    ],
    "industries": [
      "<string>"
    ],
    "metro": "San Jose, CA",
    "geo_radius_mi": 123,
    "remote_ok": true,
    "exclude_titles": [
      "<string>"
    ],
    "exclude_industries": [
      "<string>"
    ],
    "exclude_companies": [
      "<string>"
    ],
    "avoid_titles": [
      "<string>"
    ],
    "avoid_industries": [
      "<string>"
    ],
    "avoid_companies": [
      "<string>"
    ],
    "comp_band": [
      123
    ],
    "years_experience": {
      "min": 123,
      "max": 123
    },
    "min_avg_tenure_years": 123,
    "skills": [
      "<string>"
    ],
    "skills_required": [
      "<string>"
    ],
    "languages_required": [
      "<string>"
    ],
    "target_company_profile": {
      "sector": "<string>",
      "employee_range": [
        123
      ],
      "pe_backed_preferred": true
    },
    "rubric_weights": {
      "title": 123,
      "years": 123,
      "skills": 123,
      "geo": 123,
      "industry": 123,
      "seniority": 123
    }
  },
  "entityCoverage": {},
  "familyUnresolved": true,
  "familySuggestions": [
    "<string>"
  ],
  "ontologyPlan": {},
  "rawToolInput": {}
}

Get Started

Search

People

Companies

Campaigns

Authorizations

Body

Response