Search for Businesses

Note: This endpoint is currently in beta. The API response format and behavior may change in future releases.

Search for businesses based on natural language queries.

Endpoint

POST /search

Request

Headers

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

Body

FieldTypeRequiredDescription
search_querystringYesNatural language description of businesses to find
structobjectYesFields to collect for each business

Example Request

{
  "search_query": "Find me all photographers in La Jolla, California",
  "struct": {
    "company_name": "Name of the company",
    "company_email": "Email for the company",
    "address": "Where are they located",
    "city": "City they are located in",
    "state": "Which state do they operate in",
    "phone_number": "Their phone number",
    "company_linkedin": "Linkedin profile of the company if available",
    "google_profile": "Google business profile if found",
    "website": "Website of the company",
    "key_people": "name of people here separated by commas"
  }
}

Response

Success Response (200)

Returns an array of matching businesses with the requested fields.

[
  {
    "company_name": "Sunset Shores Photography",
    "company_email": "hello@sunsetshores.photo",
    "address": "789 Ocean View Dr, La Jolla, CA 92037",
    "city": "La Jolla",
    "state": "CA",
    "phone_number": "+16195551234",
    "company_linkedin": null,
    "google_profile": "https://g.page/sunset-shores-photography",
    "website": "https://www.sunsetshores.photo",
    "key_people": "Alex Rivera, Taylor Morgan"
  },
  {
    "company_name": "La Jolla Photo Studio",
    "company_email": "info@lajollaphoto.com",
    "address": "1234 Prospect St, La Jolla, CA 92037",
    "city": "La Jolla",
    "state": "CA",
    "phone_number": "+18585551234",
    "company_linkedin": "https://linkedin.com/company/lajollaphoto",
    "google_profile": "https://g.page/lajollaphoto",
    "website": "https://www.lajollaphoto.com",
    "key_people": "Sarah Johnson, Michael Chen"
  }
]

Error Response (400)

{
  "error": "Bad Request",
  "message": "Invalid search query"
}

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/search',
    headers={
        'x-api-key': 'your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        "search_query": "Find me all photographers in La Jolla, California",
        "struct": {
            "company_name": "Name of the company",
            "address": "Where are they located",
            "phone_number": "Their phone number",
            "website": "Website of the company"
        }
    }
)

results = response.json()