scrapercity 1.0.4 → 1.0.7

package/AGENT_DOCS.txt

@@ -1,6 +1,31 @@
 SCRAPERCITY API REFERENCE - FOR AI AGENTS
 ==========================================
 
+
+PRICING (auto-generated from the live catalog - do not edit)
+
+<!-- GENERATED:pricing:start -->
+| Tool | Endpoint | Price |
+|------|----------|-------|
+| `scrape_apollo` | /api/v1/scrape/apollo | $0.0039 per lead |
+| `scrape_website_finder` | /api/v1/scrape/website-finder | $0.05 per contact found |
+| `find_people` | /api/v1/scrape/skip-trace | $0.0199 per result (searches with 0 matches are billed as 1 result) |
+| `scrape_distress_list` | /api/v1/scrape/distress-list | $0.05 per property |
+| `validate_emails` | /api/v1/scrape/email-validator | $0.0072 per email |
+| `scrape_maps` | /api/v1/scrape/maps | $0.0099 per business |
+| `scrape_airbnb` | /api/v1/scrape/airbnb-email | $0.019 per result ($19.00 per 1,000) |
+| `scrape_bizbuysell` | /api/v1/scrape/bizbuysell-scraper | $0.01 per listing |
+| `scrape_crexi` | /api/v1/scrape/crexi-scraper | $0.029 per property |
+| `scrape_angi` | /api/v1/scrape/angi-angies-list-scraper | $0.01 per listing |
+| `scrape_yelp` | /api/v1/scrape/yelp-scraper | $0.01 per result |
+| `scrape_zillow_agents` | /api/v1/scrape/zillow-agents | $0.029 per agent |
+| `search_criminal_records` | /api/v1/scrape/criminal-records | $1.00 per search (only charged if records found) |
+| `scrape_store_leads` | /api/v1/scrape/store-leads | $0.0039 per lead |
+| `scrape_builtwith` | /api/v1/scrape/techstack | $4.99 per technology |
+| `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
+| `find_mobiles` | /api/v1/scrape/mobile-finder | $0.25 per number found (FREE if not found) |
+<!-- GENERATED:pricing:end -->
+
 BASE: https://app.scrapercity.com
 AUTH: Authorization: Bearer <api_key>
 ALL RESPONSES: JSON
@@ -18,6 +43,14 @@ apollo
   Cost: $0.0039/lead | Min 500, max 50000
   DELIVERY: UP TO 4 DAYS. Use webhook, not polling.
 
+apollo-filters
+  Body: { seniorityLevel, functionDept, companyIndustry, personCountry, personState,
+          companyCountry, companyState, companySize, personTitles:[], companyDomains:[],
+          companyKeywords:[], personCities:[], companyCities:[], hasPhone, count, fileName }
+  At least one filter required.
+  Returns: { runId, message }
+  Cost: $0.0039/lead | DELIVERY: UP TO 4 DAYS.
+
 maps
   Body: { searchStringsArray: ["plumbers"], locationQuery: "Denver, CO", maxCrawledPlacesPerSearch: 500 }
   Returns: { runId, datasetId, priceMicro }
@@ -149,9 +182,7 @@ GET /api/v1/apollo-status
   Returns: { useApify, message } - check if Apollo URL endpoint is available
 
 ────────────────────────────────────────
-DATABASES (GET, $149+ plans, 100k/day)
-This is the recommended path for filter-based B2B people search (by title,
-industry, location, seniority, etc). Returns instantly from a cached dataset.
+DATABASES (GET, $649 plan only, 100k/day)
 ────────────────────────────────────────
 
 GET /api/v1/database/leads?title=CTO&country=United States&hasEmail=true&page=1&limit=100
@@ -178,20 +209,19 @@ ERROR CODES
 WORKFLOW EXAMPLES
 ────────────────────────────────────────
 
-1. LEAD DATABASE (instant, recommended for B2B people search):
-   GET /api/v1/database/leads?title=CTO&industry=computer+software&hasEmail=true&page=1
-   Loop pages until page > totalPages.
-   This is the supported path for filter-based B2B contact search ($149+ plans).
-
-2. MAPS SCRAPE (fast):
+1. MAPS SCRAPE (fast):
    POST /api/v1/scrape/maps → get runId → poll status every 15s → download CSV
 
-3. APOLLO SCRAPE (slow, only when user provides an apollo.io URL):
+2. APOLLO SCRAPE (slow):
    POST /api/v1/scrape/apollo → get runId → configure webhook → wait for callback
    Do NOT poll Apollo in a tight loop. Check once per hour at most.
 
-4. ENRICH PIPELINE:
-   Database/Maps → download CSV → extract emails → POST email-validator → download validated CSV
+3. ENRICH PIPELINE:
+   Apollo/Maps → download CSV → extract emails → POST email-validator → download validated CSV
+
+4. LEAD DATABASE (instant):
+   GET /api/v1/database/leads?title=CTO&industry=computer+software&hasEmail=true&page=1
+   Loop pages until page > totalPages
 
 5. LOCAL BUSINESS PIPELINE:
    Yelp/Angi/Maps → download CSV → POST email-finder with names+domains → POST mobile-finder

package/README.md

@@ -66,6 +66,30 @@ curl -O https://app.scrapercity.com/api/downloads/RUN_ID \
   -H "Authorization: Bearer $SCRAPERCITY_API_KEY"
 ```
 
+## Pricing (auto-generated from the live catalog — do not edit)
+
+<!-- GENERATED:pricing:start -->
+| Tool | Endpoint | Price |
+|------|----------|-------|
+| `scrape_apollo` | /api/v1/scrape/apollo | $0.0039 per lead |
+| `scrape_website_finder` | /api/v1/scrape/website-finder | $0.05 per contact found |
+| `find_people` | /api/v1/scrape/skip-trace | $0.0199 per result (searches with 0 matches are billed as 1 result) |
+| `scrape_distress_list` | /api/v1/scrape/distress-list | $0.05 per property |
+| `validate_emails` | /api/v1/scrape/email-validator | $0.0072 per email |
+| `scrape_maps` | /api/v1/scrape/maps | $0.0099 per business |
+| `scrape_airbnb` | /api/v1/scrape/airbnb-email | $0.019 per result ($19.00 per 1,000) |
+| `scrape_bizbuysell` | /api/v1/scrape/bizbuysell-scraper | $0.01 per listing |
+| `scrape_crexi` | /api/v1/scrape/crexi-scraper | $0.029 per property |
+| `scrape_angi` | /api/v1/scrape/angi-angies-list-scraper | $0.01 per listing |
+| `scrape_yelp` | /api/v1/scrape/yelp-scraper | $0.01 per result |
+| `scrape_zillow_agents` | /api/v1/scrape/zillow-agents | $0.029 per agent |
+| `search_criminal_records` | /api/v1/scrape/criminal-records | $1.00 per search (only charged if records found) |
+| `scrape_store_leads` | /api/v1/scrape/store-leads | $0.0039 per lead |
+| `scrape_builtwith` | /api/v1/scrape/techstack | $4.99 per technology |
+| `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
+| `find_mobiles` | /api/v1/scrape/mobile-finder | $0.25 per number found (FREE if not found) |
+<!-- GENERATED:pricing:end -->
+
 ## Available Tools
 
 | Tool | What it does | Cost |

package/SKILL.md

@@ -15,11 +15,36 @@ GET  /api/downloads/{runId}  →  CSV file
 ```
 Auth: `Authorization: Bearer $SCRAPERCITY_API_KEY` on all requests.
 
+## Pricing (auto-generated from the live catalog — do not edit)
+
+<!-- GENERATED:pricing:start -->
+| Tool | Endpoint | Price |
+|------|----------|-------|
+| `scrape_apollo` | /api/v1/scrape/apollo | $0.0039 per lead |
+| `scrape_website_finder` | /api/v1/scrape/website-finder | $0.05 per contact found |
+| `find_people` | /api/v1/scrape/skip-trace | $0.0199 per result (searches with 0 matches are billed as 1 result) |
+| `scrape_distress_list` | /api/v1/scrape/distress-list | $0.05 per property |
+| `validate_emails` | /api/v1/scrape/email-validator | $0.0072 per email |
+| `scrape_maps` | /api/v1/scrape/maps | $0.0099 per business |
+| `scrape_airbnb` | /api/v1/scrape/airbnb-email | $0.019 per result ($19.00 per 1,000) |
+| `scrape_bizbuysell` | /api/v1/scrape/bizbuysell-scraper | $0.01 per listing |
+| `scrape_crexi` | /api/v1/scrape/crexi-scraper | $0.029 per property |
+| `scrape_angi` | /api/v1/scrape/angi-angies-list-scraper | $0.01 per listing |
+| `scrape_yelp` | /api/v1/scrape/yelp-scraper | $0.01 per result |
+| `scrape_zillow_agents` | /api/v1/scrape/zillow-agents | $0.029 per agent |
+| `search_criminal_records` | /api/v1/scrape/criminal-records | $1.00 per search (only charged if records found) |
+| `scrape_store_leads` | /api/v1/scrape/store-leads | $0.0039 per lead |
+| `scrape_builtwith` | /api/v1/scrape/techstack | $4.99 per technology |
+| `find_emails` | /api/v1/scrape/email-finder | $0.05 per email found (FREE if not found) |
+| `find_mobiles` | /api/v1/scrape/mobile-finder | $0.25 per number found (FREE if not found) |
+<!-- GENERATED:pricing:end -->
+
 ## All Scrapers (POST to /api/v1/scrape/{slug})
 
 | Slug | Input | Cost | Speed |
 |------|-------|------|-------|
 | `apollo` | `{url, count, fileName}` | $0.0039/lead | ~4 DAYS (use webhook) |
+| `apollo-filters` | `{seniorityLevel, functionDept, companyIndustry, personCountry, personState, companySize, personTitles[], companyDomains[], count}` | $0.0039/lead | ~4 DAYS |
 | `maps` | `{searchStringsArray:["query"], locationQuery, maxCrawledPlacesPerSearch}` | $0.01/place | 5-30 min |
 | `email-validator` | `{emails:["a@b.com"]}` | $0.0036/email | 1-10 min |
 | `email-finder` | `{contacts:[{first_name,last_name,domain}], autoValidateEmails, autoFindMobiles}` | $0.05/contact | 1-10 min |

package/bin/cli.mjs

@@ -266,21 +266,6 @@ async function main() {
         break
       }
 
-      // ── YouTube Email ─────────────────────────────────────
-      case 'youtube-email': {
-        let channels = args.filter(a => !a.startsWith('-'))
-        const file = flag('--file')
-        if (file) {
-          channels = [...channels, ...fs.readFileSync(file, 'utf-8').split('\n').map(l => l.trim()).filter(Boolean)]
-        }
-        if (!channels.length) die('Usage: scrapercity youtube-email @ChannelHandle https://youtube.com/@Channel  OR  --file channels.txt')
-        const r = await sc.youtubeEmail(channels)
-        console.log(`✓ YouTube email scrape started`)
-        console.log(`  Run ID: ${r.runId}`)
-        console.log(`  Poll: scrapercity status ${r.runId}`)
-        break
-      }
-
       // ── Website Finder ────────────────────────────────────
       case 'website-finder': {
         let domains = args.filter(a => !a.startsWith('-'))
@@ -366,17 +351,15 @@ async function main() {
         break
       }
 
-      // ── Property Lookup ───────────────────────────────────
-      case 'property-lookup': {
-        let addresses = args.filter(a => !a.startsWith('-'))
-        const file = flag('--file')
-        const ownerContact = flagBool('--owner-contact')
-        if (file) {
-          addresses = [...addresses, ...fs.readFileSync(file, 'utf-8').split('\n').map(l => l.trim()).filter(Boolean)]
-        }
-        if (!addresses.length) die('Usage: scrapercity property-lookup "123 Main St, Denver, CO 80202" [--owner-contact] OR --file addresses.txt')
-        const r = await sc.propertyLookup(addresses, ownerContact)
-        console.log(`✓ Property lookup started for ${addresses.length} addresses`)
+      // ── Deal Finder (distressed properties) ───────────────
+      case 'distress-list': {
+        const search = args.find(a => !a.startsWith('-'))
+        if (!search) die('Usage: scrapercity distress-list "Tampa, FL" [--types preForeclosure,auction] [--max 100]')
+        const body = { search }
+        const types = flag('--types'); if (types) body.distressTypes = types.split(',').map(s => s.trim())
+        const max = flag('--max'); if (max) body.maxItems = +max
+        const r = await sc.distressList(body)
+        console.log(`✓ Deal Finder scrape started`)
         console.log(`  Run ID: ${r.runId}`)
         console.log(`  Poll: scrapercity status ${r.runId}`)
         break
@@ -441,14 +424,13 @@ ScraperCity CLI - B2B lead generation from your terminal
     scrapercity builtwith "Technology"       Sites using a technology
     scrapercity criminal --name "X"          Criminal records search
     scrapercity airbnb --city "Miami, FL"    Airbnb host emails
-    scrapercity youtube-email @Channel       YouTuber business emails
     scrapercity website-finder acme.com      Contact info from domains
     scrapercity yelp -q "query" -l "City"    Yelp business scraper
     scrapercity angi -q "query" --zips X     Angi (Angie's List) scraper
     scrapercity zillow-agents -l "City"      Zillow real estate agents
     scrapercity bizbuysell <url>             BizBuySell listings
     scrapercity crexi <url>                  Crexi commercial real estate
-    scrapercity property-lookup "address"    Property data + owner contact
+    scrapercity distress-list \"City, ST\"   Distressed / motivated-seller properties
 
   Status:
     scrapercity status <runId>               Check run status