Note: This endpoint is currently in beta. The API response format and behavior may change in future releases.
Evaluate and qualify data against predefined criteria using autonomous research and structured analysis.
Endpoint
Request
Name | Type | Required | Description |
---|
x-api-key | string | Yes | Your Sixtyfour API key |
Content-Type | string | Yes | Must be application/json |
Body
Field | Type | Required | Description |
---|
data | object | Yes | Primary data object to be evaluated and researched |
qualification_criteria | array | Yes | List of evaluation criteria with weights and thresholds |
references | array | No | Additional URLs for research (LinkedIn, Instagram, websites) |
struct | object | No | Defines output field structure and descriptions |
Example Request
{
"data": {
"name": "Alex Johnson",
"country": "United Kingdom",
"business_type": "e-commerce seller",
"follower_count": "2500",
"post_count": "45",
"instagram_handle": "alexshop_uk"
},
"qualification_criteria": [
{
"criteria_name": "Physical Inventory",
"description": "Must own and store physical products for sales",
"weight": 10.0,
"threshold": 8.0
},
{
"criteria_name": "Target Market Location",
"description": "Must be located in UK, Germany, France, or Austria",
"weight": 8.0
}
],
"references": [
{
"url": "https://www.instagram.com/alexshop_uk",
"description": "Instagram business profile"
}
],
"struct": {
"suitability_score": "Overall qualification score (0-10)",
"disqualification_reason": "Primary reason for disqualification if applicable",
"final_verdict": "Clear YES/NO decision",
"recommendation": "ACCEPT/REJECT with reasoning"
}
}
Response
Success Response (200)
Returns structured evaluation results with detailed analysis notes.
{
"structured_data": {
"suitability_score": "9",
"disqualification_reason": "",
"final_verdict": "YES",
"recommendation": "ACCEPT - Strong inventory-based business in target market"
},
"notes": "Research of Alex Johnson, a UK-based e-commerce seller with 2500 Instagram followers, confirms operation of physical inventory business. Located in target market (United Kingdom). Instagram profile shows consistent product posts indicating active sales operations. Business model aligns well with qualification criteria."
}
Error Response (400)
{
"error": "Bad Request",
"message": "Missing required field: qualification_criteria"
}
Parameters
qualification_criteria
Each criteria object requires:
criteria_name
: Unique identifier for the criteria
description
: Detailed description of what to evaluate
weight
: Importance multiplier (higher = more important)
threshold
: Optional minimum score requirement
references
Supported URL types for automatic research:
- LinkedIn member profiles (
https://linkedin.com/in/...
)
- LinkedIn company profiles (
https://linkedin.com/company/...
)
- Instagram profiles (
https://instagram.com/...
)
- General web pages
struct
Defines output fields that will appear in structured_data
. Only specified fields will be included in the response.
Rate Limits
The API is rate limited to 1000 requests per minute per API key.
Example Usage
import requests
response = requests.post(
'https://api.sixtyfour.ai/qa-agent',
headers={
'x-api-key': 'your_api_key',
'Content-Type': 'application/json'
},
json={
"data": {
"name": "Alex Johnson",
"country": "United Kingdom",
"business_type": "e-commerce seller",
"follower_count": "2500"
},
"qualification_criteria": [
{
"criteria_name": "Physical Inventory",
"description": "Must own and store physical products",
"weight": 10.0,
"threshold": 8.0
}
],
"struct": {
"suitability_score": "Overall score (0-10)",
"final_verdict": "YES/NO decision"
}
}
)
results = response.json()