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
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 |
---|
search_query | string | Yes | Natural language description of businesses to find |
struct | object | Yes | Fields 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()