๐ŸŒ AIๆœ็ดข & ไปฃ็† ไธป้กต
Skip to content

๐ŸŽฏ LeadMagic OpenAPI Specification v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@jesseoue jesseoue released this 27 Jun 05:28
· 5 commits to main since this release
v1.0.0
39139ed

๐Ÿš€ Production-Ready OpenAPI 3.1 Specification

The first official release of the comprehensive LeadMagic API specification!

โœจ What's Included

๐Ÿ“‹ Complete API Coverage

  • All 19 endpoints documented and tested
  • 249 comprehensive examples in OpenAPI 3.1 format
  • Platform-agnostic B2B profile integration
  • Real API response examples from live testing

๐Ÿ› ๏ธ Developer Experience

  • Copy-paste ready curl examples
  • Multi-language code generation support
  • Comprehensive testing framework
  • Environment variable configuration
  • Rate limiting and error handling documentation

๐Ÿ” Security & Best Practices

  • MIT License for open source compliance
  • Environment variable configuration (no hardcoded credentials)
  • GitHub Actions for automated validation
  • Security policy and vulnerability disclosure process
  • Dependabot for automated dependency updates

๐Ÿ“š Professional Documentation

  • Complete setup and usage instructions
  • Use case examples for sales, recruitment, and business intelligence
  • Credit cost breakdown with official verification
  • Contribution guidelines and issue templates

๐Ÿ“Š Technical Details

  • OpenAPI Version: 3.1.0 (fully compliant)
  • Total Endpoints: 19
  • Examples: 249 (all OpenAPI 3.1 format)
  • File Formats: YAML (60,883 bytes) & JSON (90,756 bytes)
  • Testing: 100% endpoint coverage with live API validation

๐ŸŽฏ Key Endpoints

Credits & Email Services

    • Credit management
    • Email validation (0.05 credits)
    • Find email addresses (1 credit)
    • Find mobile numbers (5 credits)

Profile & People Services

    • Profile enrichment (1 credit)
    • Work email to profile lookup (10 credits)
    • B2B to personal email (1 credit)
    • Find people by role (0-1 credits)
    • Company employee search (1 credit)

Company Intelligence

    • Company lookup (1 credit)
    • Funding intelligence (4 credits)

Jobs & Recruitment

    • Job search (1 credit per job)
  • & - Metadata (free)

Advertisement Intelligence

    • Google ads tracking (1 per ad)
    • Meta ads tracking (1 per ad)
    • B2B ads tracking (1 per ad)
    • Detailed ad analysis (2 credits)

๐Ÿ”ง Usage

# Quick start
export LEADMAGIC_API_KEY=your-api-key-here
node test-api.js

# Import into Swagger Editor
https://editor.swagger.io/?url=https://raw.githubusercontent.com/LeadMagic/leadmagic-openapi/main/leadmagic-openapi-3.1.yaml

# Generate client code
openapi-generator-cli generate -i leadmagic-openapi-3.1.yaml -g python -o ./client

๐Ÿค Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Perfect for: Sales automation, recruitment tools, CRM integrations, lead generation platforms, business intelligence applications, and any B2B data enrichment needs.

Fully tested against the live LeadMagic API with comprehensive validation.

Assets 5
Loading