Plans & limits

Marka has three seller plans. Marketplace fees are 0% on all of them — Marka's revenue is the subscription, not a cut of your sales.

What that means for the API

A seller with no subscription — or one that has lapsed — resolves to free. A subscription counts as effective while it is trialing, active, or past due.

GET /api/v1/me reports your effective tier and the exact entitlement list your key carries. Check it rather than inferring from a plan name:

{
  "plan": {
    "tier": "pro",
    "entitlements": ["api_write", "cross_post_oneway", "ai_unlimited"],
    "limits": { "maxActiveListings": null, "aiCopilotRunsPerMonth": null, "apiRequestsPerMonth": 5000 }
  }
}

null means unlimited.

api_write

Programmatic writes are the one API capability behind a paid plan. createListing, updateListing and publishListing require the api_write entitlement when called with an API key — that is Pro or Business.

Without it, those three answer 402:

{
  "error": "Programmatic writes require the api_write entitlement (Pro plan or higher).",
  "code": "entitlement_required"
}

Two things this gate deliberately does not cover:

• Reads are ungated. Any valid key can call /v1/me, /v1/listings, /v1/search, /v1/categories and /v1/orders.
• Cookie sessions are ungated. Writes made from a signed-in browser — the Marka app's own requests — pass without api_write. Free sellers must be able to create and edit listings; "free to list" is not a write gate. Only programmatic writes are a paid feature.

Hosted MCP drafts are metered differently

The hosted MCP gateway's create_listing_draft and update_listing_draft do not go through /api/v1 and therefore do not require api_write. They consume your AI copilot run quota instead — the same monthly allowance the in-app assistant draws on: 3 runs per month on free, unlimited on Pro and Business.

So on a free plan you can draft a listing through the hosted MCP server (three times a month) but cannot create one through POST /api/v1/listings. That is the actual behaviour, not an oversight to route around.

What is enforced, and what is not

Being precise here matters more than looking generous.

Enforced

Reported but not enforced

Treat apiRequestsPerMonth as a signal of intent, not a contract. If your integration would break when it starts being enforced, size it against the published number now.

Managing your plan

Plans are changed in the Marka app, under billing. There is no API for subscriptions — a plan change takes effect for API keys as soon as the subscription is effective, since every request resolves the tier from the subscription at call time rather than from anything stamped on the key.