SiteFinderAI API

curl -X POST https://sitefinderai.com/api/public/v1/site-search \
  -H "Authorization: Bearer $SITEFINDER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ipswich-qld-combo-001" \
  -d '{ "location": "Ipswich QLD", "machineType": "combo", "collarType": "blue_collar", "radiusM": 500, "limit": 20 }'

$SITEFINDER_API_KEY stays a placeholder on purpose — run this from your server or terminal with the key in an environment variable, never from browser code.

{
  "requestId": "sample-request-id",
  "machineType": "combo",
  "location": {
    "query": "Ipswich QLD"
  },
  "lookupsCharged": 4,
  "lookupsRemaining": "<your remaining balance>",
  "sites": [
    {
      "id": "sample-1",
      "name": "Sample — Riverside Cold Storage",
      "address": "Industrial estate, Ipswich QLD",
      "category": "Distribution centre",
      "collarType": "blue_collar",
      "hours": "Mon–Sat, 5am–10pm",
      "staffEstimate": "80–120 across two shifts",
      "competitors": {
        "count": 0,
        "nearestM": null,
        "mix": "No coffee, takeaway or convenience outlet inside 500 m"
      },
      "opportunityScore": 94,
      "opportunityTier": "hot",
      "pitchSummary": "Nothing to eat or drink within 500 m. Every break turns into a drive off site and paid time the business does not get back — the strongest wage-loss pitch you can open with."
    },
    {
      "id": "sample-2",
      "name": "Sample — Northgate Precision Engineering",
      "address": "Light industrial, Ipswich QLD",
      "category": "Factory / workshop",
      "collarType": "blue_collar",
      "hours": "Mon–Fri, 6am–4pm",
      "staffEstimate": "35–60",
      "competitors": {
        "count": 1,
        "nearestM": 420,
        "mix": "1 convenience store at 420 m; no cafés"
      },
      "opportunityScore": 81,
      "opportunityTier": "hot",
      "pitchSummary": "One convenience store a 420 m walk away. An on-site combo machine still saves the round trip and captures the afternoon top-up."
    },
    {
      "id": "sample-3",
      "name": "Sample — Meridian Business Park, Tower 2",
      "address": "Suburban office park, Ipswich QLD",
      "category": "Corporate office",
      "collarType": "blue_collar",
      "hours": "Mon–Fri, 7am–7pm",
      "staffEstimate": "150+ across tenancies",
      "competitors": {
        "count": 3,
        "nearestM": 260,
        "mix": "2 cafés, 1 takeaway inside 500 m"
      },
      "opportunityScore": 64,
      "opportunityTier": "warm",
      "pitchSummary": "Cafés close by, so lead with convenience and after-hours cover: the machine serves early starters, late finishers and the floors that never leave the building."
    },
    {
      "id": "sample-4",
      "name": "Sample — Harbour View Bowls Club",
      "address": "Coastal town, Ipswich QLD",
      "category": "Club / RSL",
      "collarType": "blue_collar",
      "hours": "7 days, 10am–late",
      "staffEstimate": "12 staff, 300+ members weekly",
      "competitors": {
        "count": 2,
        "nearestM": 340,
        "mix": "1 takeaway, 1 convenience inside 500 m"
      },
      "opportunityScore": 58,
      "opportunityTier": "warm",
      "pitchSummary": "Seven-day trading and member traffic beats headcount here. Pitch a drink and snack combo plus an ATM for the bar."
    }
  ]
}