Home · APIs · People and company research · Bulk candidate compare

Bulk candidate compare API

One request, one key: POST /v1/bulk_candidate_compare. The fields below are read from a real answer captured 19 November 2026, with the value each field had (long text cut, lists cut to three items); a call can return more or fewer fields depending on what the source holds. It is not invented.

Price

10 credits a call. One call is about $0.098 and 1,000 calls are about $98 at the smallest paid plan's rate.Formula A call that comes back empty is not charged.

Try it

This call is not in the free browser demo: it needs a key. A free key (100 credits, no card) is at the trial page.

What it returns

You send:

{
  "sets": [
    {
      "subjects": [
        {
          "name": "Patrick Collison",
          "company": "Stripe"
        },
        {
          "name": "John Collison",
          "company": "Stripe"
        }
      ],
      "field": "company founder",
      "label": "t2601"
    }
  ]
}

FieldTypeValue in the captured answer
resultsarraya list of 1
setsnumber1

Measured on that call: 15954 ms.

Code

curl

curl -X POST https://api.foxapis.com/v1/bulk_candidate_compare \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sets":[{"subjects":[{"name":"Patrick Collison","company":"Stripe"},{"name":"John Collison","company":"Stripe"}],"field":"company founder","label":"t2601"}]}'

Python

import requests

r = requests.post(
    "https://api.foxapis.com/v1/bulk_candidate_compare",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={"sets":[{"subjects":[{"name":"Patrick Collison","company":"Stripe"},{"name":"John Collison","company":"Stripe"}],"field":"company founder","label":"t2601"}]},
)
print(r.json())

JavaScript

const r = await fetch("https://api.foxapis.com/v1/bulk_candidate_compare", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({"sets":[{"subjects":[{"name":"Patrick Collison","company":"Stripe"},{"name":"John Collison","company":"Stripe"}],"field":"company founder","label":"t2601"}]}),
});
console.log(await r.json());

n8n (HTTP Request node: paste it into a workflow)

{
  "nodes": [
    {
      "name": "Bulk candidate compare",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4,
      "position": [
        0,
        0
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.foxapis.com/v1/bulk_candidate_compare",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer YOUR_KEY"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\"sets\":[{\"subjects\":[{\"name\":\"Patrick Collison\",\"company\":\"Stripe\"},{\"name\":\"John Collison\",\"company\":\"Stripe\"}],\"field\":\"company founder\",\"label\":\"t2601\"}]}"
      }
    }
  ],
  "connections": {}
}

Assistants (Claude, ChatGPT, Cursor)

Connect the FoxAPIs server once; the tools it offers are listed on the MCP page.

claude mcp add --transport http foxapis https://foxapis.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Errors and limits

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.

Get my free key

More in this category: Compare people · Compare subjects · Candidate compare · Exec compare · Analyze influencer · Get investor report · Vet person · Get dossier

Same category: People and company research · all APIs

How we calculate

Data: scripts/data/endpoint-credits.json and plans.json, 2026-11-20. Every other figure on this page is copied from the record, not calculated by us.