feat: Complete LeadMagic OpenAPI 3.1 specification

🎯 Production-ready OpenAPI 3.1 specification for LeadMagic data enrichment API

✨ Features:
- 19 endpoints with comprehensive documentation
- 249 OpenAPI 3.1 compliant examples
- Platform-agnostic B2B profile integration
- Secure environment variable configuration
- Zero hardcoded credentials

📋 Complete API Coverage:
- Email Services: validation, finding, enrichment
- Mobile & Contact: phone number discovery
- Profile & People: public profile search, role/employee finding
- Company Services: search, funding intelligence
- Jobs Services: posting search with metadata
- Advertisement Intelligence: Google, Meta, B2B ads tracking

💰 Transparent Pricing:
- Email validation: 0.05 credits (20 validations per credit)
- Email finder: 1 credit per email
- Mobile finder: 5 credits per number found
- Profile search: 1 credit (public profiles only)
- Company search: 1 credit
- Company funding: 4 credits
- Jobs finder: 1 credit per job returned
- Advertisement endpoints: 1 credit per ad found

🔐 Security & Best Practices:
- Environment variable API key configuration
- Comprehensive .gitignore for sensitive data
- Rate limiting documentation (profile search: 300/min)
- Complete error handling specifications

🛠️ Developer Experience:
- Copy-paste ready curl examples
- Real API response examples
- Multi-language code generation support
- Comprehensive use case documentation

Repository: https://github.com/LeadMagic/leadmagic-openapi

Author: jesseoue

.gitignore

@@ -0,0 +1,158 @@
+# Environment variables
+.env
+.env.local
+.env.production
+.env.staging
+
+# API Keys (security)
+*.key
+api-keys.txt
+secrets.txt
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.node_repl_history
+
+# Logs
+logs
+*.log
+log/
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+public
+
+# Storybook build outputs
+.out
+.storybook-out
+
+# Temporary folders
+tmp/
+temp/
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Generated client code (when testing)
+*-client/
+generated/
+
+# Backup files
+*.backup
+*.bak
+*.orig
+
+# Test results
+test-results/
+results/
+
+# Documentation build output
+docs/build/
+
+# Swagger/OpenAPI generated files
+swagger-codegen/
+openapi-generator/
+
+# IDE specific files
+*.sublime-project
+*.sublime-workspace
+.project
+.settings/
+
+# Archive files
+*.zip
+*.tar
+*.tar.gz
+*.rar
+
+# Temporary API test files
+test-output.json
+api-responses.json