PHPackages                             artifacia/artifacia-client-php - 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. artifacia/artifacia-client-php

ActiveLibrary[API Development](/categories/api)

artifacia/artifacia-client-php
==============================

A php client to integrate Visual Recommendation feature from Artifacia API.

0.1.3.3(9y ago)0422MITPHPPHP >=5.3

Since Jul 23Pushed 9y ago2 watchersCompare

[ Source](https://github.com/artifacia/artifacia-client-php)[ Packagist](https://packagist.org/packages/artifacia/artifacia-client-php)[ RSS](/packages/artifacia-artifacia-client-php/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependenciesVersions (7)Used By (0)

Artifacia php Client
====================

[](#artifacia-php-client)

This php client is a simple wrapper around our powerful Visual Discovery [API](http://docs.artifacia.com/).

The wrapper allows you to create your own index of images on which you would like to enhance the product discovery experiences. It also allows you to get various types of recommendations which are listed below.

- Visual Recommendation
- Cross Product Recommendation
- Personalized Recommendation

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

[](#installation)

To install the package you can follow the steps:-

```
composer require artifacia/artifacia-client-php
```

Getting Started
---------------

[](#getting-started)

The API is really easy and simple to use. First you need to visit [this](http://www.artifacia.com/requestaccess/) page and request for username and password. Using that credentials you can create your constructor and get stated.

```
require __DIR__ . '/vendor/autoload.php';
$api_key = ;
use Artifacia\Client;
$client = new Client($api_key);
```

### Creating your index

[](#creating-your-index)

The first step is to create a index of the items that you would like to store in our databases to perform search against. If you don't have data ready right now you can quickly get started with our [sample data](https://github.com/artifacia/artifacia-client-php/blob/master/sample_data.json). Once the data is stored and indexed we will inform you shortly.

```
$data = file_get_contents("./sample_data.json");
$data_indexing_response = $client->upload_item_data($data);
echo $data_indexing_response;
```

### Performing Visual Recommendation

[](#performing-visual-recommendation)

Once you receive a notification from us about the status of the indexed data, you are ready to search. You can search for a product ID indexed in the sample data you inserted/uploaded. And also you can specify the number of results to be returned as well as set the attribute (like color, pattern, material etc.) if you want to prioritize the result as given below.

```
$sample_prod_id = 2761;
$num = 4;
$filters = array('color' => 1, 'pattern' => 1);
$query_response = $client->get_visual_recommendation($sample_prod_id, $num, $filters);
echo $query_response;
```

###  Health Score

25

—

LowBetter than 36% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

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 ~22 days

Total

6

Last Release

3517d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/36192230?v=4)[ashish122](/maintainers/ashish122)[@ashish122](https://github.com/ashish122)

---

Top Contributors

[![Vgandhi9](https://avatars.githubusercontent.com/u/5131088?v=4)](https://github.com/Vgandhi9 "Vgandhi9 (2 commits)")

### Embed Badge

![Health badge](/badges/artifacia-artifacia-client-php/health.svg)

```
[![Health](https://phpackages.com/badges/artifacia-artifacia-client-php/health.svg)](https://phpackages.com/packages/artifacia-artifacia-client-php)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

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