Public Marketplace Data

Public Catalog API

Retrieve public ALEFBA catalog data without seller credentials.

Available

Endpoint

GEThttps://alefba.eu/api/v1/catalog

Authentication

No API key is required for the public catalog endpoint.

Query parameters

Parameter	Type	Required	Description
`page`	Integer	No	Requested result page. Use a positive integer.
`limit`	Integer	No	Number of records requested. The documented maximum is 50.

cURL example

curl --request GET \
  --url "https://alefba.eu/api/v1/catalog?page=1&limit=20" \
  --header "Accept: application/json"

JavaScript example

const response = await fetch(
  "https://alefba.eu/api/v1/catalog?page=1&limit=20",
  { headers: { Accept: "application/json" } }
);

if (!response.ok) {
  throw new Error(`ALEFBA API returned ${response.status}`);
}

const catalog = await response.json();
console.log(catalog);

PHP example

<?php
$url = "https://alefba.eu/api/v1/catalog?page=1&limit=20";

$context = stream_context_create([
    "http" => [
        "method" => "GET",
        "header" => "Accept: application/json\r\n",
        "timeout" => 15,
    ],
]);

$response = file_get_contents($url, false, $context);

if ($response === false) {
    throw new RuntimeException("Unable to retrieve the ALEFBA catalog.");
}

$catalog = json_decode($response, true, 512, JSON_THROW_ON_ERROR);

Response handling

The endpoint returns JSON public-catalog data. Integrations should inspect the HTTP status before parsing the response and should tolerate the addition of new response fields.

Canonical URL: Use /api/v1/catalog in all new integrations and public documentation.