Cvyon B2B API

Integrate Cvyon's highly-structured talent pool directly into your ATS, CRM, or custom internal tools. Our REST API provides programmatic access to candidates who have opted in to be contacted by recruiters.

Authentication

Authenticate your API requests by including your secret API key in the Authorization HTTP header.

API keys require an active recruiter access pass (30 days from purchase). Keys are managed in the Recruiter Portal.

HTTP

Authorization: Bearer YOUR_API_KEY

Rate Limits

To ensure platform stability, API requests are rate-limited based on your access tier.

Pro Tier: 100 requests per minute, up to 10,000 requests per day.

If you exceed the rate limit, the API will return a 429 Too Many Requests HTTP status code.

Search Talent

Search for candidates across the Cvyon database. You can filter by keywords, job titles, or location.

GET/v1/talent

Query Parameters

Parameter	Type	Description
query	string	Search term (e.g. "software engineer", "marketing").
country	string	Filter by candidate location.
limit	integer	Max results to return (default 20, max 100).

Examples

cURL

bash

curl -X GET "https://api.cvyon.com/v1/talent?query=software+engineer" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Node.js

javascript

const fetchCandidates = async () => {
  const response = await fetch('https://api.cvyon.com/v1/talent?query=software+engineer', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  });
  
  const data = await response.json();
  console.log(data);
};

Python

python

import requests

url = "https://api.cvyon.com/v1/talent"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
params = {
    "query": "software engineer"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

Response

json

{
  "success": true,
  "data": [
    {
      "id": "cnd_123456789",
      "name": "Jane Doe",
      "email": "jane@example.com",
      "target_role": "Senior Software Engineer",
      "country": "United States",
      "skills": ["React", "TypeScript", "Node.js"],
      "resume_url": "https://cvyon.com/resume/jane-doe"
    }
  ],
  "meta": {
    "total_count": 145,
    "has_more": true
  }
}