PHPackages                             larowka/kudago-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. larowka/kudago-api

ActiveLibrary[API Development](/categories/api)

larowka/kudago-api
==================

PHP Wrapper for KudaGo API

v0.4.1(4y ago)011MITPHPPHP ^7.3|^8.0

Since Oct 29Pushed 4y ago1 watchersCompare

[ Source](https://github.com/larowka/kudago-api)[ Packagist](https://packagist.org/packages/larowka/kudago-api)[ Docs](https://github.com/larowka/kudago-api)[ RSS](/packages/larowka-kudago-api/feed)WikiDiscussions master Synced yesterday

READMEChangelog (6)Dependencies (3)Versions (7)Used By (0)

PHP KudaGo API
==============

[](#php-kudago-api)

PHP wrapper for [KudaGo API](https://docs.kudago.com/api/) base on Guzzle Http Client

Requirements
------------

[](#requirements)

- PHP 7.3 or later

Installation
------------

[](#installation)

Via [Composer](https://getcomposer.org/):

```
$ composer require larowka/kudago-api
```

or you can update your composer.json file:

```
{
    "require": {
      "larowka/kudago-api": "0.2.*"
    }
}
```

### Laravel

[](#laravel)

### Lumen

[](#lumen)

Usage examples
--------------

[](#usage-examples)

### Create API Wrapper instance

[](#create-api-wrapper-instance)

```
use Larowka\KudaGo\Api;

$kudago = new Api();
```

### Traits

[](#traits)

Some entities have common traits for sorting, details, filter by time or coordinates, and paginator. Use IDE annotations or [official documentation](https://docs.kudago.com/api/#) for allowed arguments.

```
$events = $kudago->events();

// Sorting
$events->orderBy('id', '-publication_date') // Order by id ASC and by publication_date DESC
        ->get();

// Details
$events->expand('images', 'dates') // Get detailed information of images and dates in result
        ->get();

// Filter by time
$events->before('2022', '!Y')    // Get results between 2021-10-12 and 2022 year
        ->after('2021-10-12', 'Y-m-d')
        ->get();

// Filter by coordinates
$events->inRadius(59.9, 30.3, 10000) // Include only events in radius 10000 meters around point [latitude, longitude]
        ->get();

// Paginator
$events->page(3) // Page number
        ->pageSize(35) // Items on page
        ->get();

// Concrete object
$events->find(161043); // find by event ID
```

### API Endpoints

[](#api-endpoints)

##### Object categories ([doc](https://docs.kudago.com/api/#page:%D0%BA%D0%B0%D1%82%D0%B5%D0%B3%D0%BE%D1%80%D0%B8%D0%B8-%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82%D0%BE%D0%B2))

[](#object-categories-doc)

```
$categories = $kudago->categories();

$eventCategories = $categories->events()->get();
$placeCategories = $categories->places()->get();
```

##### Locations ([doc](https://docs.kudago.com/api/#page:%D0%B3%D0%BE%D1%80%D0%BE%D0%B4%D0%B0))

[](#locations-doc)

> traits: Sort

```
$locations = $kudago->locations();

$cities = $locations->orderBy('timezone')->get();
$city = $locations->find('spb');
```

##### Search ([doc](https://docs.kudago.com/api/#page:%D0%BF%D0%BE%D0%B8%D1%81%D0%BA))

[](#search-doc)

> traits: Paginator, Details, CoordsFilter

```
$kudago->search()
        ->query('art') // Query string
        ->type('event') // Include only specific type: news, event, place, list
        ->expand('place', 'dates')
        ->get();
```

##### Events ([doc](https://docs.kudago.com/api/#page:%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F))

[](#events-doc)

> traits: Paginator, Sort, Details, TimeFilter, CoordsFilter

```
$kudago->events()
        ->after('2021-10-11')
        ->orderBy('-publication_date')
        ->page(5)
        ->pageSize(50)
        ->get();
```

##### Events of the day ([doc](https://docs.kudago.com/api/#page:%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F-%D0%B4%D0%BD%D1%8F))

[](#events-of-the-day-doc)

```
$kudago->eventsOfTheDay()->get();
```

##### News ([doc](https://docs.kudago.com/api/#page:%D0%BD%D0%BE%D0%B2%D0%BE%D1%81%D1%82%D0%B8))

[](#news-doc)

```
$kudago->news()->get();
```

##### Lists ([doc](https://docs.kudago.com/api/#page:%D0%BF%D0%BE%D0%B4%D0%B1%D0%BE%D1%80%D0%BA%D0%B8))

[](#lists-doc)

> traits: Paginator, Sort, Details

```
$kudago->lists()->get();
```

##### Places ([doc](https://docs.kudago.com/api/#page:%D0%BC%D0%B5%D1%81%D1%82%D0%B0))

[](#places-doc)

> traits: Paginator, Sort, Details, TimeFilter, CoordsFilter

```
$kudago->places()
        ->ids(157,33338) // Include only specific places by placeID
        ->get();
```

##### Movies ([doc](https://docs.kudago.com/api/#page:%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D1%8B))

[](#movies-doc)

> traits: Paginator, Sort, Details, TimeFilter

```
$kudago->movies()->get();
```

##### Showings ([doc](https://docs.kudago.com/api/#page:%D0%BF%D0%BE%D0%BA%D0%B0%D0%B7%D1%8B))

[](#showings-doc)

> traits: Paginator, Sort, Details, TimeFilter

```
$kudago->showings()
        ->inPlace(19757) // Include only showings in specific place
        ->get();
```

##### Movie Showings ([doc](https://docs.kudago.com/api/#page:%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D1%8B,header:%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D1%8B-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%BF%D0%BE%D0%BA%D0%B0%D0%B7%D0%BE%D0%B2-%D1%84%D0%B8%D0%BB%D1%8C%D0%BC%D0%B0))

[](#movie-showings-doc)

> traits: Paginator, Sort, Details, TimeFilter

```
$kudago->movieShowings(3315)
        ->inPlace(19757) // Include only showings in specific place
        ->get();
```

##### Agents ([doc](https://docs.kudago.com/api/#page:%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D1%8B))

[](#agents-doc)

```
$kudago->agents()->get();
```

##### Agent Roles ([doc](https://docs.kudago.com/api/#page:%D1%80%D0%BE%D0%BB%D0%B8))

[](#agent-roles-doc)

```
$kudago->agentRoles()->get();
```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Total

6

Last Release

1626d ago

PHP version history (2 changes)v0.1.0PHP ^7.3

v0.2.0PHP ^7.3|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab33634a5e9af0cb56cfeb945d487121f1aacf4f635fee0c30a7b0d51fb85474?d=identicon)[larowka](/maintainers/larowka)

---

Top Contributors

[![larowka](https://avatars.githubusercontent.com/u/46128719?v=4)](https://github.com/larowka "larowka (14 commits)")

---

Tags

api-wrapperkudagophpsdkapikudago

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/larowka-kudago-api/health.svg)

```
[![Health](https://phpackages.com/badges/larowka-kudago-api/health.svg)](https://phpackages.com/packages/larowka-kudago-api)
```

###  Alternatives

[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)