{
  "openapi": "3.0.3",
  "info": {
    "title": "CEA Digital — Skip Trace & LLC Owner Phone Finder, Video Transcript & Hook Scraper, eBay Sold Comps & Building Permits API",
    "version": "1.2.0",
    "description": "High-speed pure-HTTP enrichment & intelligence APIs: (1) Skip Trace & Property / LLC Owner Phone Finder — Emails, SOS & KYB (`cea_digital/skip-trace-owner-phone-finder`), (2) Instagram, TikTok & YouTube Transcript Scraper — AI Video to Text, Hooks & OCR (`cea_digital/instagram-tiktok-youtube-transcript-scraper`), (3) eBay & Mercari Sold Listings Scraper — Sold Prices, Best Offer Comps & Deal Sniper (`cea_digital/ebay-sold-listings-comps-scraper`), and (4) Building Permits & Code Violations Scraper + LLC Owner Skip-Trace (`cea_digital/building-permits-code-violations-scraper`). Direct Unified Key (`cea_live_`) available at https://ceadigital.io/tools ($2 Tripwire / $29/mo Growth).",
    "contact": {
      "name": "CEA Digital",
      "url": "https://ceadigital.io/tools"
    },
    "x-cea-direct-wallet": {
      "direct_wallet_url": "https://ceadigital.io/tools",
      "tripwire_plan": "$2.00 for 100 verified hits (one-time)",
      "subscriptions": {
        "sub_growth_29": "$29/mo for 5,000 verified hits/mo",
        "sub_scale_79": "$79/mo for 15,000 verified hits/mo",
        "sub_agency_249": "$249/mo for 60,000 verified hits/mo"
      }
    }
  },
  "servers": [
    {
      "url": "https://ceadigital.io",
      "description": "CEA Digital Production Gateway (Unified Key / Stripe MPP 402 / x402)"
    }
  ],
  "components": {
    "securitySchemes": {
      "UnifiedBearerKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "cea_live_<JWT>",
        "description": "Persistent Unified Key (`cea_live_...`) from https://ceadigital.io/tools"
      },
      "StripeMPPToken": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Stripe-MPP-Token",
        "description": "Stripe Machine Payments Protocol (MPP) Shared Payment Token (`spt_...`)"
      },
      "X402PaymentSignature": {
        "type": "apiKey",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "description": "Coinbase x402 Base L2 USDC micropayment signature"
      }
    }
  },
  "security": [
    { "UnifiedBearerKey": [] },
    { "StripeMPPToken": [] },
    { "X402PaymentSignature": [] }
  ],
  "paths": {
    "/v1/tools/skip-trace-owner-phone-finder": {
      "post": {
        "operationId": "skipTraceOwnerPhoneFinder",
        "summary": "Skip Trace & Property / LLC Owner Phone Finder — Emails, SOS & KYB",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "zillowOrMapsDatasetId": { "type": "string" },
                  "companyOrOwnerNames": { "type": "array", "items": { "type": "string" } },
                  "addresses": { "type": "array", "items": { "type": "string" } },
                  "reportType": {
                    "type": "string",
                    "enum": ["skip_trace_only", "pierce_llc_and_skip_trace", "full_kyb_guarantor_diligence"],
                    "default": "pierce_llc_and_skip_trace"
                  },
                  "watchlistId": { "type": "string" },
                  "onlyNew": { "type": "boolean", "default": true }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Verified LLC owner, wireless phones, emails, OFAC KYB status, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402 (`PAYMENT-REQUIRED`), and Direct Checkout links."
          }
        }
      }
    },
    "/v1/tools/skip-trace": {
      "post": {
        "operationId": "skipTraceLlcPiercer",
        "summary": "Pierce LLC Owners, Skip-Trace Wireless Phones/Emails & Screen U.S. Treasury OFAC SDN (Legacy Alias)",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "zillowOrMapsDatasetId": { "type": "string" },
                  "companyOrOwnerNames": { "type": "array", "items": { "type": "string" } },
                  "addresses": { "type": "array", "items": { "type": "string" } },
                  "reportType": {
                    "type": "string",
                    "enum": ["skip_trace_only", "pierce_llc_and_skip_trace", "full_kyb_guarantor_diligence"],
                    "default": "pierce_llc_and_skip_trace"
                  },
                  "watchlistId": { "type": "string" },
                  "onlyNew": { "type": "boolean", "default": true }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Verified LLC owner, wireless phones, emails, OFAC KYB status, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402 (`PAYMENT-REQUIRED`), and Direct Checkout links."
          }
        }
      }
    },
    "/v1/tools/instagram-tiktok-youtube-transcript-scraper": {
      "post": {
        "operationId": "instagramTiktokYoutubeTranscriptScraper",
        "summary": "Instagram, TikTok & YouTube Transcript Scraper — AI Video to Text, Hooks & OCR",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "igOrTiktokDatasetId": { "type": "string" },
                  "videoUrls": { "type": "array", "items": { "type": "string" } },
                  "translateTo": { "type": "string", "example": "es" },
                  "generateUgcBrief": { "type": "boolean", "default": true },
                  "monitorMode": { "type": "boolean", "default": false },
                  "webhookUrl": { "type": "string" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Extracted 0-3s spoken & visual OCR hooks, retention score, transcript, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402, and Direct Checkout links."
          }
        }
      }
    },
    "/v1/tools/video-hook": {
      "post": {
        "operationId": "shortVideoHookTranscriptExtractor",
        "summary": "Extract 0-3s Spoken Hook, 0-3s Burned-In Visual OCR Hook, Time-Coded Transcript & Localized UGC Brief (Legacy Alias)",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "igOrTiktokDatasetId": { "type": "string" },
                  "videoUrls": { "type": "array", "items": { "type": "string" } },
                  "translateTo": { "type": "string", "example": "es" },
                  "generateUgcBrief": { "type": "boolean", "default": true },
                  "monitorMode": { "type": "boolean", "default": false },
                  "webhookUrl": { "type": "string" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Extracted 0-3s spoken & visual OCR hooks, retention score, transcript, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402, and Direct Checkout links."
          }
        }
      }
    },
    "/v1/tools/ebay-sold-listings-comps-scraper": {
      "post": {
        "operationId": "ebaySoldListingsCompsScraper",
        "summary": "eBay & Mercari Sold Listings Scraper — Sold Prices, Best Offer Comps & Deal Sniper",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fbMarketplaceDatasetId": { "type": "string" },
                  "keywords": { "type": "array", "items": { "type": "string" } },
                  "condition": { "type": "string", "enum": ["any", "new", "used", "for_parts"], "default": "used" },
                  "filterDealers": { "type": "boolean", "default": true },
                  "monitorMode": { "type": "boolean", "default": false },
                  "underpricedThresholdPct": { "type": "number", "default": 25 }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Realized sold comps, median sold USD, net flip profit after fees, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402, and Direct Checkout links."
          }
        }
      }
    },
    "/v1/tools/sold-comps": {
      "post": {
        "operationId": "ebayMercariSoldCompsApi",
        "summary": "Fetch Realized 30-Day Sold Comps (eBay/Mercari), Net Flip Margin After 13.25% Fees & Deal Sniper Alerts (Legacy Alias)",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fbMarketplaceDatasetId": { "type": "string" },
                  "keywords": { "type": "array", "items": { "type": "string" } },
                  "condition": { "type": "string", "enum": ["any", "new", "used", "for_parts"], "default": "used" },
                  "filterDealers": { "type": "boolean", "default": true },
                  "monitorMode": { "type": "boolean", "default": false },
                  "underpricedThresholdPct": { "type": "number", "default": 25 }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Realized sold comps, median sold USD, net flip profit after fees, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402, and Direct Checkout links."
          }
        }
      }
    },
    "/v1/tools/building-permits-code-violations-scraper": {
      "post": {
        "operationId": "buildingPermitsCodeViolationsScraper",
        "summary": "Building Permits & Code Violations Scraper — Municipal Triggers, LLC Owner Skip-Trace & Contractor KYB",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "citiesOrZips": { "type": "array", "items": { "type": "string" } },
                  "permitTypes": { "type": "array", "items": { "type": "string" } },
                  "minJobValueUsd": { "type": "number", "default": 25000 },
                  "autoSkipTraceOwner": { "type": "boolean", "default": true },
                  "screenContractorKyb": { "type": "boolean", "default": true },
                  "watchlistId": { "type": "string" },
                  "onlyNew": { "type": "boolean", "default": true }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Municipal building permits, code violations, pierced LLC owner wireless phones, contractor OFAC KYB, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402, and Direct Checkout links."
          }
        }
      }
    },
    "/v1/tools/building-permits": {
      "post": {
        "operationId": "municipalPermitLienTriggerScraper",
        "summary": "Extract Active Building Permits & Code Violations + Auto-Chained LLC Owner Wireless Phone Skip-Trace (Short Alias)",
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "citiesOrZips": { "type": "array", "items": { "type": "string" } },
                  "permitTypes": { "type": "array", "items": { "type": "string" } },
                  "minJobValueUsd": { "type": "number", "default": 25000 },
                  "autoSkipTraceOwner": { "type": "boolean", "default": true },
                  "screenContractorKyb": { "type": "boolean", "default": true }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Municipal building permits, code violations, pierced LLC owner wireless phones, and `_meta.direct_wallet_url`."
          },
          "402": {
            "description": "Payment Required — includes Stripe MPP (`X-Stripe-MPP-Challenge`), x402, and Direct Checkout links."
          }
        }
      }
    },
    "/v1/billing/plans": {
      "get": {
        "operationId": "getBillingPlans",
        "summary": "List Unified `cea_live_` Tripwire ($2) and Recurring Subscription Tiers ($29/$79/$249)",
        "responses": {
          "200": { "description": "Catalog of unified plans and covered tools." }
        }
      }
    },
    "/v1/billing/portal": {
      "post": {
        "operationId": "createBillingPortalSession",
        "summary": "Create a 1-Click Stripe Customer Portal Session for FTC/ARL Self-Serve Cancellation",
        "responses": {
          "200": { "description": "Stripe Customer Portal redirect URL." }
        }
      }
    },
    "/v1/tools/free-preview": {
      "post": {
        "operationId": "runFreeSingleRowPreview",
        "summary": "Zero-Auth 1-Row Free Live Preview (Skip-Trace, Video Hook, Sold Comps, or Building Permits)",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tool": {
                    "type": "string",
                    "enum": ["skip-trace", "video-hook", "sold-comps", "building-permits"],
                    "default": "skip-trace"
                  },
                  "query": {
                    "type": "string",
                    "default": "APEX COMMERCIAL HOLDINGS LLC, 1201 Main St, Columbia, SC 29201"
                  }
                }
              },
              "example": {
                "tool": "skip-trace",
                "query": "APEX COMMERCIAL HOLDINGS LLC, 1201 Main St, Columbia, SC 29201"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "1-row live preview result with `_meta.direct_wallet_url` upgrade link."
          }
        }
      }
    },
    "/v1/health": {
      "get": {
        "operationId": "getGatewayHealth",
        "summary": "Sub-50ms Gateway Uptime & Service Level Health Check (RapidAPI / Zyla SLA Monitor)",
        "security": [],
        "responses": {
          "200": { "description": "Gateway online and healthy." }
        }
      }
    }
  }
}