Back

    Buyamia Directory API

    v1.1.0

    Categories, Regions & Countries

    Reference data. All of it is public; there is no internal variant.

    GET
    /v1/categories

    Business categories. Supports `parent_id` and `depth` filtering plus pagination.

    categories.read
    GET
    /v1/categories/:id

    Single business category.

    categories.read
    GET
    /v1/product-categories

    Product category taxonomy (separate tree from business categories).

    categories.read
    GET
    /v1/regions

    Regions, optionally filtered by `country_id`.

    regions.read
    GET
    /v1/regions/:id

    Single region.

    regions.read
    GET
    /v1/countries

    Countries. Note the scope is `regions.read`, not a separate countries scope.

    regions.read

    Cache taxonomy locally. It changes rarely and every business/product filter needs the IDs.

    Current as of API 1.1.0 — released 7 September 2026