PHPackages                             bahricanli/laravel-mosaic - 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. bahricanli/laravel-mosaic

ActiveLibrary[API Development](/categories/api)

bahricanli/laravel-mosaic
=========================

Mosaic Public API icin Laravel istemci kutuphanesi — kurumlarin sosyal medya istatistiklerini (takipci, gecmis, postlar, ozet) ceker.

v1.0.0(today)02↑2900%MITPHPPHP >=7.0

Since Jun 19Pushed todayCompare

[ Source](https://github.com/bahricanli/laravel-mosaic)[ Packagist](https://packagist.org/packages/bahricanli/laravel-mosaic)[ RSS](/packages/bahricanli-laravel-mosaic/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (2)Versions (2)Used By (0)

Laravel Mosaic
==============

[](#laravel-mosaic)

[Mosaic](https://www.mosaic.net.tr) Public API için Laravel istemci kütüphanesi. Kurumların Mosaic tarafından toplanan sosyal medya verilerini (takipçi sayıları, geçmiş trend, paylaşımlar, özet metrikler) kendi Laravel uygulamalarına **salt-okunur** olarak çekmesini sağlar.

- ✅ Laravel **5.5+** (8 / 9 / 10 / 11 / 12 dahil)
- ✅ PHP **7.0+**
- ✅ Guzzle 6 / 7
- ✅ Otomatik paket keşfi (auto-discovery)

---

Kurulum
-------

[](#kurulum)

Paket henüz Packagist'te yayınlanmadığı için, projenizin `composer.json` dosyasına VCS deposu ekleyin:

```
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/bahricanli/laravel-mosaic"
    }
]
```

Ardından:

```
composer require bahricanli/laravel-mosaic
```

### Yapılandırma

[](#yapılandırma)

`.env` dosyanıza kuruma özel bilgileri ekleyin:

```
MOSAIC_BASE_URL=https://www.mosaic.net.tr
MOSAIC_API_KEY=msk_xxxxxxxxxxxxxxxx
```

API key'i Mosaic panelinden **Kurumlar → (kurum) → Düzenle → Public API** bölümünden üretebilirsiniz.

İsterseniz config dosyasını publish edin:

```
php artisan vendor:publish --tag=mosaic-config
```

### Laravel 5.5 — manuel kayıt (auto-discovery kapalıysa)

[](#laravel-55--manuel-kayıt-auto-discovery-kapalıysa)

`config/app.php`:

```
'providers' => [
    BahriCanli\Mosaic\MosaicServiceProvider::class,
],

'aliases' => [
    'Mosaic' => BahriCanli\Mosaic\Facades\Mosaic::class,
],
```

---

Kullanım
--------

[](#kullanım)

### Facade ile

[](#facade-ile)

```
use Mosaic;

$overview = Mosaic::overview();
echo $overview['summary']['total_followers'];

$followers = Mosaic::followers();
$history   = Mosaic::followersHistory('instagram', 30);
$posts     = Mosaic::posts('instagram', 20);
```

### Dependency injection ile

[](#dependency-injection-ile)

```
use BahriCanli\Mosaic\MosaicClient;

public function dashboard(MosaicClient $mosaic)
{
    return view('dashboard', [
        'overview' => $mosaic->overview(),
    ]);
}
```

### Birden fazla kurum / runtime key

[](#birden-fazla-kurum--runtime-key)

```
$client = new MosaicClient('https://www.mosaic.net.tr', 'msk_xxx');
$data   = $client->overview();

// veya mevcut client'ın key'ini değiştir
$other = app('mosaic')->withApiKey('msk_yyy')->overview();
```

---

Metotlar
--------

[](#metotlar)

MetotAçıklama`overview()`Kurum bilgisi + her platformun güncel takipçisi + birleşik özet (toplam, 7 günlük büyüme)`followers()`Her platformun en güncel takipçi sayısı`followersHistory($platform = null, $days = 30)`Tarih bazlı takipçi serisi (grafik). `days` en fazla 365.`posts($platform = null, $limit = 20)`Postlar + etkileşim metrikleri. `limit` en fazla 50.Tüm metotlar API yanıtını ilişkisel dizi (`array`) olarak döner. Hata durumunda `BahriCanli\Mosaic\Exceptions\MosaicException` fırlatılır.

### Örnek `overview()` yanıtı

[](#örnek-overview-yanıtı)

```
{
  "organization": { "name": "Radyo C", "slug": "radyo-c" },
  "summary": { "total_followers": 123487, "growth_7d": 540, "growth_7d_percent": 0.44 },
  "platforms": [
    { "platform": "instagram", "platform_label": "Instagram", "followers": 22303 }
  ],
  "updated_at": "2026-06-19"
}
```

Tam API dokümantasyonu:

---

Lisans
------

[](#lisans)

MIT

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance100

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4894f69d95bdf9814c8c0db5876852c4381ccaba0a2d98a224ea1269123217f8?d=identicon)[bmericc](/maintainers/bmericc)

---

Top Contributors

[![bmericc](https://avatars.githubusercontent.com/u/16552?v=4)](https://github.com/bmericc "bmericc (3 commits)")

---

Tags

laravelanalyticsapi clientsocial mediamosaic

### Embed Badge

![Health badge](/badges/bahricanli-laravel-mosaic/health.svg)

```
[![Health](https://phpackages.com/badges/bahricanli-laravel-mosaic/health.svg)](https://phpackages.com/packages/bahricanli-laravel-mosaic)
```

###  Alternatives

[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)[smodav/mpesa

M-Pesa API implementation

16167.1k1](/packages/smodav-mpesa)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.1k1](/packages/jasara-php-amzn-selling-partner-api)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

232.5k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

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