{
  "schemaVersion": 1,
  "actorId": "yhmUbg1s3WK9fSkRj",
  "actor": "maydit/building-permit-address-lookup",
  "publicActor": true,
  "documentationUpdatedAt": "2026-11-16T04:00:59.040Z",
  "documentationBuild": "1.0.10",
  "inputSchema": "https://mayd-it.com/data-tools/actors/building-permit-address-lookup/input-schema.json",
  "exampleInput": "https://mayd-it.com/data-tools/actors/building-permit-address-lookup/input.json",
  "documentation": "https://mayd-it.com/data-tools/actors/building-permit-address-lookup/guide.md",
  "pricing": "https://apify.com/maydit/building-permit-address-lookup/pricing",
  "nativeOpenApi": "https://api.apify.com/v2/actors/yhmUbg1s3WK9fSkRj/builds/default/openapi.json",
  "mcp": {
    "url": "https://mcp.apify.com?tools=fetch-actor-details,call-actor,maydit/building-permit-address-lookup",
    "config": "https://mayd-it.com/data-tools/actors/building-permit-address-lookup/mcp.json",
    "authentication": "OAuth through a compatible client; execution needs your own authorized Apify access.",
    "exactActor": "maydit/building-permit-address-lookup"
  },
  "api": {
    "origin": "https://api.apify.com/v2",
    "actorPath": "actors/yhmUbg1s3WK9fSkRj",
    "startMethod": "POST",
    "startPath": "actors/yhmUbg1s3WK9fSkRj/runs",
    "statusPath": "actor-runs/{runId}",
    "itemsPath": "datasets/{defaultDatasetId}/items",
    "diagnosticsPath": "key-value-stores/{defaultKeyValueStoreId}/records/SUMMARY",
    "authentication": "Bearer APIFY_TOKEN supplied through the environment; never included in downloadable files.",
    "startOnce": true,
    "retryStart": false,
    "runOptions": {
      "maxTotalChargeUsd": 0.05,
      "timeout": 300,
      "restartOnError": false,
      "forcePermissionLevel": "LIMITED_PERMISSIONS"
    },
    "download": {
      "pageSize": 100,
      "maxItems": 1000,
      "maxBytes": 20000000
    },
    "poll": {
      "intervalSeconds": 5,
      "deadlineSeconds": 330
    }
  },
  "sourceCredentials": [
    {
      "field": "socrataAppToken",
      "title": "Socrata app token (optional)",
      "environmentVariable": "MAYDIT_INPUT_SOCRATA_APP_TOKEN",
      "required": false
    }
  ],
  "firstRunGuidance": "For the $0.05 starter, edit input.json so addresses contains only one address in the selected city. The documented three-address recipe can exceed this cap: at the recorded FREE-tier rate, three saved verdicts plus the default-memory start event cost $0.06005. Keep the cap and narrow the first run; consult current pricing before approving a larger run.",
  "runner": "https://mayd-it.com/data-tools/actors/building-permit-address-lookup/run-actor.mjs",
  "output": {
    "kind": "Apify default dataset",
    "fields": [
      {
        "name": "queryAddress",
        "label": "Address",
        "format": "text"
      },
      {
        "name": "city",
        "label": "City",
        "format": "text"
      },
      {
        "name": "state",
        "label": "State",
        "format": "text"
      },
      {
        "name": "matchConfidence",
        "label": "Address match confidence",
        "format": "text"
      },
      {
        "name": "permitCount",
        "label": "Permits",
        "format": "number"
      },
      {
        "name": "permitCapReached",
        "label": "Permit fetch cap reached",
        "format": "boolean"
      },
      {
        "name": "openPermitCount",
        "label": "Open permits",
        "format": "number"
      },
      {
        "name": "statusUnknownCount",
        "label": "Permits with unknown status",
        "format": "number"
      },
      {
        "name": "issuedNeverFinaledCount",
        "label": "Issued, not finaled",
        "format": "number"
      },
      {
        "name": "expiredButOpen",
        "label": "Expired & open",
        "format": "boolean"
      },
      {
        "name": "expiredButOpenCount",
        "label": "Expired and open count",
        "format": "number"
      },
      {
        "name": "earliestPermit",
        "label": "Earliest matched permit",
        "format": "text"
      },
      {
        "name": "latestPermit",
        "label": "Latest matched permit",
        "format": "text"
      },
      {
        "name": "humanSummary",
        "label": "Summary",
        "format": "text"
      },
      {
        "name": "verdictBasis",
        "label": "Evidence behind finding",
        "format": "text"
      },
      {
        "name": "scrapedAt",
        "label": "Checked at",
        "format": "text"
      }
    ],
    "fieldsScope": "Documented default dataset view, not an exhaustive JSON Schema. Native OpenAPI and Actor documentation remain authoritative; preserve nulls and nested values.",
    "sample": "https://mayd-it.com/data-tools/actors/building-permit-address-lookup/sample.json",
    "captureEvidence": "https://mayd-it.com/data-tools/actors/building-permit-address-lookup/evidence.json",
    "completeness": "SUCCEEDED is a process status. Inspect SUMMARY and source-specific coverage before interpreting results; download completeness does not establish source completeness."
  }
}
