markaDocs
API reference

Search the 200 most recently listed active listings

GET
/v1/search

Authorization

apiKey
x-api-key<token>

API key created in your Marka account settings, sent as an x-api-key header (an Authorization: Bearer mk_… header is accepted as an equivalent spelling). Key-authenticated writes additionally require the api_write entitlement, which the Pro plan and above carry. A signed-in browser session cookie is also accepted for interactive exploration from the Marka web app; SDK and server-to-server clients always use a key.

In: header

Query Parameters

city?string

City to anchor the radius filter on; must match a city present in the catalogue. A city that matches none — including one whose listings have all sold — returns no results, rather than silently dropping the location filter and answering with the whole country.

limit?integer

Page size, 1-100. Defaults to 50.

Range1 <= value <= 100
maxPrice?integer

Highest acceptable price, in integer minor units.

Range0 <= value <= 9007199254740991
minPrice?integer

Lowest acceptable price, in integer minor units.

Range0 <= value <= 9007199254740991
offset?integer

Number of results to skip. Defaults to 0. Search covers the 200 most recently listed active listings, so an offset at or past that ceiling returns an empty page — it does not reach older items.

Range0 <= value <= 9007199254740991
pickup?boolean

Only listings offering local pickup.

q?string

Free-text query. Omit to browse without a text filter.

radiusKm?number

Search radius around city, in kilometres. Ignored unless city is supplied.

Range0 < value
shipping?boolean

Only listings offering shipping.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/search"
{  "hasMore": true,  "limit": 1,  "offset": 0,  "query": "string",  "results": [    {      "categoryPath": "string",      "condition": "new",      "createdAt": "2019-08-24T14:15:22Z",      "currency": "string",      "id": "string",      "imageUrls": [        "string"      ],      "location": {        "addressLine1": "string",        "addressLine2": "string",        "city": "string",        "country": "string",        "latitude": -90,        "longitude": -180,        "postalCode": "string",        "region": "string"      },      "pickupEnabled": true,      "price": 0,      "sellerAccountId": "string",      "shippingEnabled": true,      "title": "string"    }  ]}

Publish a draft listing POST

Publishing requires available stock (quantityTotal - quantityReserved > 0) for both unique and multi-quantity inventory. Otherwise returns HTTP 400 with code out_of_stock and message All units are held by open orders. when quantityTotal > 0, or Active listings require stock. when quantityTotal is 0.

Update listing fields PATCH

Next Page