REST API

The Makinari REST API allows you to programmatically interact with the platform’s core features.

To use the API, you will need an API Key. Learn how to generate one in the First Steps: API Keys guide.

Authentication

All API requests require an API key passed as a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Keep your API key secret. Do not expose it in client-side code or public repositories. Rotate it immediately if it is compromised.

Base URL

https://api.makinari.io/v1

All endpoints are versioned. The current stable version is v1.

API Sections

• Visitors - Track and identify site visitors.
• Finder - Search for contacts and companies.
• Robots - Manage and control your robot instances.

Response format

All responses are JSON. Successful responses use standard HTTP status codes:

• 200 - Success
• 201 - Resource created
• 400 - Bad request, check your parameters
• 401 - Unauthorized, invalid or missing API key
• 404 - Resource not found
• 429 - Rate limit exceeded
• 500 - Server error

Error responses include a message field with a human-readable description of the problem.