Build agents that book real-world services.

curl -X POST https://hirelocalcrew.com/api/agent/v1/quote \
  -H "Content-Type: application/json" \
  -d '{
    "provider_id": "PROVIDER_ID",
    "consumer_name": "Jane Smith",
    "consumer_phone": "+19195551234",
    "consumer_zip": "27604",
    "job_description": "Two dead pines, need removal + stump grind."
  }'

import requests

# Optional: API key for attribution + higher rate limit
API_KEY = "YOUR_API_KEY"  # or None

# 1. Search for providers
res = requests.get(
    "https://hirelocalcrew.com/api/agent/v1/providers",
    params={"service": "tree-removal", "location": "raleigh"},
    headers={"Authorization": f"Bearer {API_KEY}"} if API_KEY else {},
)
providers = res.json()["data"]["providers"]
provider = providers[0]

# 2. Submit a quote on behalf of the consumer
res = requests.post(
    "https://hirelocalcrew.com/api/agent/v1/quote",
    json={
        "provider_id": provider["id"],
        "consumer_name": "Jane Smith",
        "consumer_phone": "+19195551234",
        "consumer_zip": "27604",
        "job_description": "Two dead pines, need removal + stump grind.",
    },
    headers={"Authorization": f"Bearer {API_KEY}"} if API_KEY else {},
)
print(res.json())

const API_KEY = process.env.HIRELOCALCREW_API_KEY; // optional

// 1. Search
const search = await fetch(
  "https://hirelocalcrew.com/api/agent/v1/providers?service=tree-removal&location=raleigh",
  { headers: API_KEY ? { Authorization: `Bearer ${API_KEY}` } : {} }
);
const { data } = await search.json();
const provider = data.providers[0];

// 2. Quote
const quote = await fetch("https://hirelocalcrew.com/api/agent/v1/quote", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    ...(API_KEY ? { Authorization: `Bearer ${API_KEY}` } : {}),
  },
  body: JSON.stringify({
    provider_id: provider.id,
    consumer_name: "Jane Smith",
    consumer_phone: "+19195551234",
    consumer_zip: "27604",
    job_description: "Two dead pines, need removal + stump grind.",
  }),
});
console.log(await quote.json());

{
  "name": "request_local_service_quote",
  "description": "Submit a quote request to a local home-service provider (tree removal, plumbing, HVAC, roofing, etc.) on behalf of the user. Returns a tracking ID; the provider responds to the user within 30 minutes during business hours.",
  "input_schema": {
    "type": "object",
    "required": ["service", "city_or_zip", "consumer_name", "job_description"],
    "properties": {
      "service": {
        "type": "string",
        "description": "Service slug, e.g. 'tree-removal', 'plumbing', 'hvac-repair'"
      },
      "city_or_zip": {
        "type": "string",
        "description": "Either a city name (e.g. 'Raleigh') or 5-digit ZIP"
      },
      "consumer_name": { "type": "string" },
      "consumer_phone": { "type": "string", "description": "E.164 format preferred" },
      "consumer_email": { "type": "string" },
      "job_description": {
        "type": "string",
        "description": "What the consumer needs done, with detail"
      },
      "preferred_timing": {
        "type": "string",
        "description": "e.g. 'ASAP', 'this weekend', 'within 2 weeks'"
      }
    }
  }
}

{
  "type": "function",
  "function": {
    "name": "request_local_service_quote",
    "description": "Submit a quote request to a vetted local home-service provider on behalf of the user.",
    "parameters": {
      "type": "object",
      "required": ["provider_id", "consumer_name", "job_description"],
      "properties": {
        "provider_id": { "type": "string" },
        "consumer_name": { "type": "string" },
        "consumer_phone": { "type": "string" },
        "consumer_zip": { "type": "string" },
        "job_description": { "type": "string" },
        "preferred_timing": { "type": "string" }
      }
    }
  }
}