{
  "openapi": "3.0.0",
  "info": {
    "title": "CEA Digital B2B Enrichment & Market Intelligence Suite",
    "description": "Skip Trace & Anonymous LLC Owner Phone Finder, Viral Short-Video 0-3s Hook & Transcript Scraper, eBay/Mercari Realized Sold Comps API, and Municipal Building Permits & Code Violations Scraper.",
    "version": "1.2.0"
  },
  "servers": [
    {
      "url": "https://ceadigital.io"
    }
  ],
  "paths": {
    "/v1/tools/skip-trace-owner-phone-finder": {
      "post": {
        "operationId": "skipTraceOwnerPhoneFinder",
        "summary": "Pierce anonymous LLCs via State SOS filings and skip-trace owner wireless phones, emails, and U.S. Treasury OFAC KYB.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "companyOrOwnerNames": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "LLC names or person names to skip-trace."
                  },
                  "addresses": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Property or registered street addresses."
                  },
                  "reportType": {
                    "type": "string",
                    "enum": [
                      "skip_trace_only",
                      "pierce_llc_and_skip_trace",
                      "full_kyb_guarantor_diligence"
                    ],
                    "default": "pierce_llc_and_skip_trace"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Verified owner phones, emails, LLC officers, and OFAC standing."
          }
        }
      }
    },
    "/v1/tools/instagram-tiktok-youtube-transcript-scraper": {
      "post": {
        "operationId": "videoHookTranscriptScraper",
        "summary": "Extract 0-3s spoken hooks, burned-in 0-3s visual OCR captions, retention scores, and full transcripts from TikTok, Reels & Shorts.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "videoUrls": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "TikTok, Instagram Reel, or YouTube Short URLs."
                  },
                  "translateTo": {
                    "type": "string",
                    "description": "Optional ISO language code (e.g. es, de, pt, fr)."
                  },
                  "generateUgcBrief": {
                    "type": "boolean",
                    "default": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Extracted 0-3s spoken & visual hooks, transcript, and UGC clone brief."
          }
        }
      }
    },
    "/v1/tools/ebay-sold-listings-comps-scraper": {
      "post": {
        "operationId": "ebaySoldListingsComps",
        "summary": "Fetch 90-day realized sold prices (including Accepted Best Offers), IQR spread, 13.25% fee net profit, and deal sniper alerts.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keywords": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Product SKUs, models, or search keywords."
                  },
                  "condition": {
                    "type": "string",
                    "enum": [
                      "any",
                      "new",
                      "used",
                      "for_parts"
                    ],
                    "default": "used"
                  },
                  "underpricedThresholdPct": {
                    "type": "number",
                    "default": 25
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Realized sold comps, median price, sell-through rate, and net flip profit."
          }
        }
      }
    },
    "/v1/tools/building-permits-code-violations-scraper": {
      "post": {
        "operationId": "buildingPermitsCodeViolations",
        "summary": "Extract active municipal building permits & code violations + auto-pierce anonymous LLC property owners to wireless phones & KYB.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "citiesOrZips": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Cities or ZIP codes (e.g. Austin, TX or 78701)."
                  },
                  "permitTypes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Permit types (roofing, solar, commercial_ti, code_violation, adu)."
                  },
                  "minJobValueUsd": {
                    "type": "number",
                    "default": 25000
                  },
                  "autoSkipTraceOwner": {
                    "type": "boolean",
                    "default": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Permits, code violations, pierced LLC owner phones/emails, and contractor KYB."
          }
        }
      }
    }
  }
}