Getting Started with the API
Make your first API call in minutes. Learn how to create an API key, authenticate requests, and integrate Meirra's services.
Overview
The Meirra API provides programmatic access to our email verification, contact enrichment, lead generation, and SEO analysis services. With a simple REST interface and pay-as-you-go pricing, you can integrate powerful data tools directly into your applications. This guide will walk you through creating your first API key and making your first request.
Create an API Key
To use the API, you need an API key. Log in to your Meirra account and navigate to the Developer Dashboard. Click 'Create API Key' and give it a descriptive name (e.g., 'Production App' or 'Testing'). Your key will be displayed once - copy it and store it securely. API keys start with 'mk_live_' for production or 'mk_test_' for testing environments.
Make Your First Request
Let's verify an email address. Include your API key in the x-api-key header: ```bash curl -X POST https://api.meirra.com/v1/email/verify \ -H "x-api-key: mk_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{"email": "test@example.com"}' ``` You'll receive a JSON response with the verification result, including whether the email is valid, deliverable, and any risk indicators.
Response Format
All API responses follow a consistent format: ```json { "success": true, "data": { ... }, "usage": { "cost": 0.005, "balanceRemaining": 19.995 } } ``` The `success` field indicates if the request succeeded. The `data` field contains the result. The `usage` field shows how much the request cost and your remaining balance.
Next Steps
Now that you've made your first request, explore more endpoints: • **Email Verification** - Verify single emails or batch process up to 100 at once • **Contact Enrichment** - Find emails for contacts by name and company • **Company Enrichment** - Get all contacts for a company domain • **Lead Search** - Search Google Maps or government registries for businesses • **SEO Analysis** - Run PageSpeed tests, track keywords, and generate audits Remember to check your balance regularly and top up when needed to avoid service interruptions.
Related Articles
Authentication
Deep dive into API key management, IP allowlists, and security best practices.
Email Verification
Learn about single and batch email verification endpoints.
Leads Endpoints
Search for business leads from Google Maps across 200+ countries. Find local businesses with websites, phone numbers, and addresses.
Rate Limits
Understand API rate limits, response headers, and best practices for handling rate limit errors gracefully.