This API provides endpoints to find company logos and addresses by searching their websites and using AI to extract the information from HTML.

Find company logos by analyzing website HTML.

Find company addresses by searching about/contact pages.

{
  "name": "Company Name",        // Required: The company name
  "website": "https://...",      // Optional: Company website URL
  "country": "Country Name",     // Required: Company's country
  "state": "State/Province"      // Optional: Company's state or province
}

{
  "success": true,
  "logoUrl": "https://example.com/logo.png",
  "searchedUrl": "https://example.com"
}

{
  "success": true,
  "address": "123 Main Street, City, State 12345, Country",
  "searchedUrl": "https://example.com",
  "foundOnPage": "https://example.com/contact"
}

{
  "success": false,
  "error": "Error description",
  "searchedUrl": "https://example.com"  // Optional: URL that was searched
}

1. Website Discovery: If no website is provided, searches DuckDuckGo to find the company's official website
2. HTML Fetching: Retrieves the raw HTML from the company's homepage
3. AI Logo Extraction: Uses OpenAI's GPT-4o-mini to analyze the HTML and locate the company logo
4. URL Normalization: Converts relative URLs to absolute URLs for the logo image

1. Website Discovery: Same as logo finding
2. Page Discovery: Tries multiple pages including homepage, /about, /contact, /about-us, /contact-us, /company, /locations, /office, /headquarters
3. HTML Analysis: Fetches HTML from each page until an address is found
4. AI Address Extraction: Uses OpenAI to locate and format the company's physical address

curl -X POST https://your-val-url/find-logo \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Apple Inc",
    "website": "https://apple.com",
    "country": "United States",
    "state": "California"
  }'

curl -X POST https://your-val-url/find-address \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Microsoft",
    "country": "United States",
    "state": "Washington"
  }'

curl -X POST https://your-val-url/find-logo \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Google",
    "country": "United States"
  }'

The API handles various error scenarios:

• Missing required fields (name, country)
• Website not found during search
• Website unreachable or returns errors
• Logo not found in website HTML
• AI service errors

This API uses OpenAI's services, so it's subject to OpenAI's rate limits. For production use, consider implementing caching and rate limiting.

• Built with Hono framework on Val Town
• Uses OpenAI GPT-4o-mini for logo extraction
• Supports both provided websites and automatic website discovery
• Handles relative and absolute URL conversion
• Includes proper error handling and logging