Getting Started with MagicalAPI

This guide will help you integrate MagicalAPI into your application quickly and efficiently. Follow these steps to start using our API services.

Base URL

All API requests should be made to:

https://gw.magicalapi.com

Step 1: Sign Up and Get Your API Key

Before you can start using MagicalAPI, you need an API key. Please note that API keys are only available with Pro plans:

1. Sign up for a free account
2. Upgrade to a Pro plan
3. Visit the API Info section
4. Generate and securely store your API key

See the API Key guide for detailed instructions.

Step 2: Set Up Authentication

Every API request requires authentication using your API key. Include it in the request headers:

{
  "Content-type": "application/json",
  "api-key": "YOUR-API-KEY"
}

Learn more in the Authentication guide.

Step 3: Make Your First Request

Our API uses a two-step request process:

1. Submit your request and receive a request_id
2. Use the request_id to retrieve your results

Follow the Create a Request guide to learn how to structure your API calls.

Step 4: Handle Responses

Common response status codes:

• 200 - Success
• 201 - Request created successfully
• 401 - Authentication failed
• 402 - Insufficient credits

See Status Codes for complete error handling guidance.

Step 5: Explore Our Services

MagicalAPI offers several powerful services:

• Profile Data - Extract LinkedIn profile information
• Company Data - Get detailed company insights
• Resume Parser - Parse resumes into structured data
• Resume Review - Get resume feedback and analysis
• Resume Score - Score resumes objectively

Developer Tools

To speed up your integration:

• Download our Postman Collection
• Use our Python SDK

tip

Monitor your credit usage in the MagicalAPI Panel and review pricing details on our Pricing Page.