{
  "openapi": "3.0.1",
  "info": {
    "title": "Local Business Email Finder: Emails for Shops With No Website",
    "description": "Find emails for local businesses for outreach, including ones with no website of their own. Each email is checked for a working mail domain (MX) and comes with its source URL and a confidence score. Pay only for emails that pass the check.",
    "version": "1.1",
    "x-build-id": "EMN2NcxA8eYXBPyUi"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/transparent_meteorite~no-website-business-email-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-transparent_meteorite-no-website-business-email-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/transparent_meteorite~no-website-business-email-finder/runs": {
      "post": {
        "operationId": "runs-sync-transparent_meteorite-no-website-business-email-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/transparent_meteorite~no-website-business-email-finder/run-sync": {
      "post": {
        "operationId": "run-sync-transparent_meteorite-no-website-business-email-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "title": "Business type",
            "type": "string",
            "description": "What kind of business to find on OpenStreetMap, for example barber, hairdresser, car_repair, plumber, dentist, nail_salon, or a raw OSM tag like shop=bakery. Leave empty if you paste your own list below."
          },
          "location": {
            "title": "City or region",
            "type": "string",
            "description": "Where to look, for example \"Ferndale, MI\", \"Austin, TX\" or \"Wayne County, Michigan\". Used together with Business type."
          },
          "businesses": {
            "title": "Your own business list (optional)",
            "type": "array",
            "description": "Already have names? Paste one per line, for example \"Lefty's Barbershop, Ferndale, MI\". Good for leads that only have a Facebook page. Via API you can also send objects with name, city, state, phone, website, facebook, instagram.",
            "items": {
              "type": "string"
            }
          },
          "maxBusinesses": {
            "title": "Max businesses to check",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "How many businesses to check in this run. You are charged only for the ones that end up with a verified email.",
            "default": 50
          },
          "onlyWithoutWebsite": {
            "title": "Only businesses without their own website",
            "type": "boolean",
            "description": "Skip businesses whose OpenStreetMap record lists their own website. Keeps social-only, booking-page-only and no-site businesses (handy for web design, marketing and booking-software outreach).",
            "default": false
          },
          "onlyWithEmail": {
            "title": "Only output rows with a verified email",
            "type": "boolean",
            "description": "Turn on to get a clean email list. Off by default: rows without an email still carry phone, address and socials, and cost nothing.",
            "default": false
          },
          "nameKeywords": {
            "title": "Name keywords (optional)",
            "type": "string",
            "description": "Comma-separated words the business name must contain, for example \"braid, loc\". Leave empty for all."
          },
          "minConfidence": {
            "title": "Minimum confidence",
            "minimum": 0.5,
            "maximum": 0.95,
            "type": "number",
            "description": "From 0.5 to 0.95, for example 0.6. An email is verified (and charged) only at or above this attribution confidence. 0.6 is a good balance; 0.8 keeps mostly addresses found on the business's own site or booking page.",
            "default": 0.6
          },
          "allowRoleEmails": {
            "title": "Allow role addresses (info@, booking@)",
            "type": "boolean",
            "description": "For small local businesses the info@ inbox is usually the owner's. Turn off to keep only named addresses. System addresses (noreply@, privacy@) are always dropped.",
            "default": true
          },
          "searchEngine": {
            "title": "Search engine",
            "enum": [
              "duckduckgo",
              "serper",
              "none"
            ],
            "type": "string",
            "description": "Public web search used to find each business's pages, for example DuckDuckGo. DuckDuckGo needs no key but is rate-limited and finds fewer emails. Serper uses your own Serper.dev key (Google results) and finds the most.",
            "default": "duckduckgo"
          },
          "serperApiKey": {
            "title": "Serper.dev API key (optional)",
            "type": "string",
            "description": "Only used when Search engine is Serper, for example a key from serper.dev/api-key. Sent to Serper only, never written to the output or logs."
          },
          "googlePlacesApiKey": {
            "title": "Google Places API key (optional)",
            "type": "string",
            "description": "Recommended. Your own Google Maps Platform key with Places API (New) enabled, for example a key from console.cloud.google.com. One lookup per business without a known website finds the site listed on its Google profile, which is where most verified emails come from. Billed by Google to your key."
          },
          "proxyConfiguration": {
            "title": "Proxy for search requests",
            "type": "object",
            "description": "Used only for DuckDuckGo search requests, so a big run is not slowed by rate limits, for example Apify Proxy (default). Business websites are always read directly and politely. Leave empty to use Apify Proxy when your plan has it; accounts without proxy access run without one."
          },
          "maxPagesPerBusiness": {
            "title": "Max pages per business",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Upper limit of web pages read per business, for example 6 (own site, contact page, booking page, directory profile). Every page is checked against robots.txt first.",
            "default": 6
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}