Sycamore API

Build on the Contractor Graph

Search 80+ verified contractors via REST. Semantic search, structured filters, and rich profiles — one API key away.

Get API KeyView Docs

Quick Start

Make your first request

bash
curl "https://sycamore-api.com/api/v1/search?q=forestry+mulching+Texas&product=mulch&limit=5" \
  -H "X-API-Key: sycamore_your_key_here"

Replace sycamore_your_key_here with your API key. All requests require the X-API-Key header.

Endpoints

API Reference

GET/api/v1/search— Search contractors
ParamTypeDescription
qstringNatural language query — uses semantic vector search when provided
productstringFilter by product: mulch, row, arbor, forestry, rig, goat
statestringTwo-letter state code — matches base state or service_states
limitintegerResults to return (1–50, default 10)

Response

Example response

json
{
  "results": [
    {
      "id": "3f7a1bc4-...",
      "company_name": "Lone Star Land Clearing",
      "city": "Waco",
      "state": "TX",
      "tier": "premium",
      "claimed": true,
      "product": "mulch",
      "job_types": ["commercial", "firebreak", "fence_line"],
      "terrain_capabilities": ["flat", "rolling", "brush"],
      "equipment_brands": ["Fecon", "Caterpillar"],
      "hp_min": 250,
      "hp_max": 450,
      "service_radius_miles": 300,
      "service_states": ["TX", "LA", "OK"],
      "phone": "+1 (254) 555-0182",
      "email": "[email protected]",
      "website": "https://lonestarland.com",
      "confidence_score": 0.9412
    }
  ],
  "query": "forestry mulching Texas",
  "total": 5,
  "mode": "semantic"
}
confidence_scoreSemantic similarity (0–1) when q is provided
claimedVerified contractor — phone/email/website included
tier"free" or "premium" — premium listings appear first
service_statesAll states the contractor is willing to travel to

Auth

Your API Keys

Sign in to create and manage your API keys.

Sign in to manage keys

Pricing

Simple, usage-based pricing

Free

$0 / mo

Get started, no card required

  • ✓1,000 requests / month
  • ✓All products (mulch, row, etc.)
  • ✓Semantic + filter search
  • ✓Basic rate limiting
Popular

Dev

$49 / mo

For integrations and production apps

  • ✓50,000 requests / month
  • ✓Everything in Free
  • ✓Priority rate limits
  • ✓Webhook support (coming soon)
  • ✓Email support