Enrich company data with additional information and find associated people.

Endpoint

POST /enrich-company

Request

Headers

NameTypeRequiredDescription
x-api-keystringYesYour Sixtyfour API key
Content-TypestringYesMust be application/json

Body

FieldTypeRequiredDescription
target_companyobjectYesCompany data to enrich
structobjectYesFields to collect
find_peoplebooleanNoWhether to find people associated with the company
research_planstringNoOptional research plan to guide enrichment
people_focus_promptstringNoDescription of people to find, typically includes the roles or responsibilities of the people you’re looking for

Example Request

{
  "target_company": {
    "company_name": "Pacific View Studios",
    "address": "1234 Ocean View Dr, La Jolla, CA 92037",
    "phone_number": "+16195551234",
    "website": "https://pacificview.studio"
  },
  "struct": {
    "instagram_url": "Instagram url for the photography company",
    "num_employees": "How many employees work there, give approximation if you don't have exact number"
  },
  "find_people": true,
  "research_plan": "Check their website, online profiles, and linkedin for the people. Looking for the individual portfolios of the employees can help too",
  "people_focus_prompt": "Find me the owners of the company and the office manager"
}

Response

Success Response (200)

Returns enriched company data including leads if requested.

{
  "notes": "Pacific View Studios is a boutique photography company based in La Jolla, California. They specialize in luxury wedding photography, high-end portrait sessions, and commercial work for local businesses. The company has a strong social media presence and professional website. The business operates with a small, dedicated team of photographers and support staff.",
  "structured_data": {
    "company_name": "Pacific View Studios",
    "address": "1234 Ocean View Dr, La Jolla, CA 92037",
    "phone_number": "+16195551234",
    "website": "https://pacificview.studio",
    "num_employees": "5-10 employees",
    "instagram_url": "https://www.instagram.com/pacificview.studio",
    "leads": [
      {
        "name": "Sarah Chen",
        "email": "sarah@pacificview.studio",
        "title": "Creative Director & Lead Photographer",
        "phone": "+16195551234",
        "score": 9,
        "linkedin": "https://www.linkedin.com/in/sarah-chen-photography"
      },
      {
        "name": "Michael Rodriguez",
        "email": "michael@pacificview.studio",
        "title": "Office Manager",
        "phone": "+16195551234",
        "score": 8,
        "linkedin": "https://www.linkedin.com/in/michael-rodriguez-pvs"
      }
    ]
  },
  "findings": [
    "Company specializes in luxury wedding photography and high-end portraits",
    "Located at 1234 Ocean View Dr, La Jolla, CA 92037",
    "Phone number: +16195551234",
    "Website: https://pacificview.studio",
    "Instagram: https://www.instagram.com/pacificview.studio",
    "Team size: 5-10 employees",
    "Creative Director: Sarah Chen",
    "Office Manager: Michael Rodriguez"
  ],
  "references": {
    "https://pacificview.studio": "Official company website with services and portfolio",
    "https://www.instagram.com/pacificview.studio": "Company Instagram profile showing recent work",
    "https://www.linkedin.com/in/sarah-chen-photography": "LinkedIn profile of the Creative Director",
    "https://www.linkedin.com/in/michael-rodriguez-pvs": "LinkedIn profile of the Office Manager"
  },
  "confidence_score": 9.5
}

Error Response (400)

{
  "error": "Bad Request",
  "message": "Invalid company data"
}

Type Casting

The API automatically handles type casting for structured data output with intelligent type preservation and conversion.

Type Priority Order

  1. Explicit Type Definitions (Highest Priority) - Specified in struct field definitions
  2. Original Input Types - Types from target_company when not explicitly overridden
  3. Inferred Types - From example values in struct
  4. Default to String (Lowest Priority)

Supported Types

TypeExample Values
"str" or "string""Pacific View Studios"
"int" or "integer"50, 1000
"float"95.5, 3.14
"bool" or "boolean"true, false
"list"["item1", "item2"]
"dict"{"key": "value"}

Examples

Type Override:

{
  "target_company": {"num_employees": 25, "is_public": true},
  "struct": {
    "num_employees": {"type": "str"},  // Overrides original int type
    "industry": "Primary business sector"  // New field as string
  }
}
// Output: {"num_employees": "25", "is_public": true, "industry": "Photography"}

Explicit Type Definition:

{
  "struct": {
    "employee_count": {"description": "Number of employees", "type": "int"},
    "is_verified": {"description": "Verification status", "type": "bool"}
  }
}
// Output: {"employee_count": 25, "is_verified": true}

Type Inference from Values:

{
  "struct": {
    "rating": 4.5,        // Inferred as float
    "is_remote": false,   // Inferred as bool
    "founded_year": 2020  // Inferred as int
  }
}

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/enrich-company',
    headers={
        'x-api-key': 'your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        "target_company": {
            "company_name": "Pacific View Studios",
            "address": "1234 Ocean View Dr, La Jolla, CA 92037",
            "phone_number": "+16195551234",
            "website": "https://pacificview.studio"
        },
        "struct": {
            "instagram_url": "Instagram url for the photography company",
            "num_employees": "How many employees work there"
        },
        "find_people": true,
        "people_focus_prompt": "Find me the owners of the company"
    }
)

results = response.json()