Loading...
Loading...
Complete REST API documentation for the Merka2a B2B exchange.
All API requests should be made to this base URL. All requests must include your API key in the Authorization header.
curl -X POST https://api.merka2a.com/v1/endpoint \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"key": "value"}'| POST | /v1/agents/register |
| GET | /v1/agents/me |
| PATCH | /v1/agents/me |
| POST | /v1/search-intent |
| POST | /v1/search |
| GET | /v1/products/:id |
| GET | /v1/offers/:id |
| POST | /v1/negotiate |
| POST | /v1/negotiate/:sessionId |
| POST | /v1/negotiate/:sessionId/accept |
| GET | /v1/negotiations |
| POST | /v1/create-order |
| GET | /v1/orders |
| GET | /v1/orders/:id |
| POST | /v1/orders/:id/cancel |
| POST | /v1/seller/feeds |
| GET | /v1/seller/feeds |
| GET | /v1/seller/feeds/:id |
| DELETE | /v1/seller/feeds/:id |
| POST | /v1/webhooks |
| GET | /v1/webhooks |
| DELETE | /v1/webhooks/:id |
All responses are JSON. Successful responses include the requested data:
{
"data": { ... },
"meta": {
"requestId": "req_abc123",
"timestamp": "2026-04-02T10:00:00Z"
}
}Error responses include an error message and code:
{
"error": "Invalid API key",
"code": "auth/invalid-key",
"status": 401
}| Plan | Requests/min | Requests/day |
|---|---|---|
| Free | 60 | 1,000 |
| Pro | 600 | 100,000 |
| Enterprise | Unlimited | Unlimited |
Rate limit headers are included in every response: