PHPackages                             talentcircles/php\_sdk - 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. talentcircles/php\_sdk

ActiveLibrary[API Development](/categories/api)

talentcircles/php\_sdk
======================

A developer library for accessing TalentCircles network APIs

v1.0.1(8y ago)015MITPHPPHP ^5.3.3 || ^7.0

Since Nov 14Pushed 8y ago4 watchersCompare

[ Source](https://github.com/talentcircles/php_sdk)[ Packagist](https://packagist.org/packages/talentcircles/php_sdk)[ RSS](/packages/talentcircles-php-sdk/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (3)DependenciesVersions (5)Used By (0)

TalentCircles PHP Developer Kit
===============================

[](#talentcircles-php-developer-kit)

This library allows developers to integrate a TalentCircles network into their own application through HTTP calls to that network's REST API endpoints.

Setup
-----

[](#setup)

Setup is simple and easy with composer. See [instructions here](https://getcomposer.org/download/) if you do not have composer installed. Once you have composer, use the following command from your project root:

```
$ composer require talentcircles/php_sdk

```

Usage
-----

[](#usage)

First initialize the SDK object:

```
// Use your Network URL, App ID, and Api Key to connect to your API.
// It is reccomended that this information be kept somewhere in your
// project that is not accessible from the public html directory.
$network_url='https://127.0.1.1';
$app_id='romeo-5931c22e4190b';
$api_key='Y1IgDgriOjAo5hKMzZ0RxC';

$tc = new TalentCirclesSDK($network_url, $app_id, $api_key);
```

Then call any of the functions below to access data on the TalentCircles network you are accessing. For example, to get a Job object, call `getJob()` with a job id:

```
$obj_job = $tc->getJob(6579620);
```

Functions
---------

[](#functions)

### Job Functions

[](#job-functions)

**getJob(INT $job\_id)** - Get a single Job object for the job posting identified by $job\_id

```
$obj_job = $tc->getJob(6579620);
```

**getJobs(ARR $job\_ids)** - Get multiple Job objects for the job postings identified by an array of $job\_ids

```
$job_ids = array(
    4551686,
    7480159
);
$ar_jobs = $tc->getJobs($job_ids);
```

**getJobMatchingCandidates(INT $job\_id)** - Get an array of matching user objects of possible candidates for the job posting identified by $job\_id

```
$ar_users = $tc->getJobMatchingCandidates(6579620);
```

**getSimilarJobs(INT $job\_id)** - Get an array of job objects with job postings similar to the job posting identified by $job\_id

```
$ar_users = $tc->getSimilarJobs(6579620);
```

**createJob(STR $job\_title, STR $job\_description, ARR $jobDetails)** - Post a new Job ad, returns the new Job object

```
$jobTitle = "Advanced Front-end Developer";
$jobDescription = "We need somone really good at developing";

$jobDetails = array(
    'available_on' => 'November 14, 2017',
    'category_id' => 17,
    'commitment_level' => 'Full-Time',
    'apply_behavior' => 'url redirect',
    'urlRedirect' => 'https://talentcircles.com'
);

$ar_job = $tc->createJob($jobTitle, $jobDescription, $jobDetails);
```

**searchJobs(ARR $search\_params, INT $page, INT $results\_per\_page)** - Get an array of Job objects from the database, using SPHINX search

```
$search_params = array(
    'tenants' => 570
);

$page = 1;
$results_per_page = 10;

$ar_jobs = $tc->searchJobs($search_params, $page, $results_per_page);
```

**updateJob(INT $job\_id, ARR $update\_data)** - Update an existing job posting identified by $job\_id, returns an updated Job object

```
$job_id = 8698590;

$update_data = array(
    'available_on' => 'November 11, 2017',
    'commitment_level' => 'Part-Time',
);

$obj_job = $tc->updateJob($job_id, $update_data);
```

### User Functions

[](#user-functions)

**getUser(INT $user\_id)** - Get a single User object for the user profile identified by $user\_id

```
$user_id = 12770260;
$obj_user = $tc->getUser($user_id);
```

**getUsers(ARR $user\_ids)** - Get an array of User objects for the profiles identified by an array of $user\_ids

```
$user_ids = array(
    12770260,
    12769405
);
$ar_users = $tc->getUsers($user_ids);
```

**getUserMatchingJobs(INT $user\_id)** - Get an array of Job objects that may be suitable for the user profile identified by $user\_id

```
$user_id = 12770260;
$ar_jobs = $tc->getUserMatchingJobs($user_id);
```

**getUserStories(INT $user\_id, INT $offset, INT $limit)** - Get an array of Story objects posted by the user profile identified by $user\_id

```
$user_id = 10961800;
$ar_stories = $tc->getUserStories($user_id);
```

**createUser(ARR $user\_data)** - Create a new User profile, returns the new User object

```
$user_data = array(
    'firstname' => 'Gerald',
    'lastname' => 'de Jager',
    'email' => 'gedj@austincity.gov',
    'zipcode' => 78704
);

$ar_user = $tc->createUser($user_data);
```

**searchUsers(ARR $search\_params, INT $page, INT $results\_per\_page)** - Get an array of User objects from the database, using SPHINX search

```
$search_params = array(
    'circles' => 376
);

$page = 1;
$results_per_page = 10;

$ar_users = $tc->searchUsers($search_params, $page, $results_per_page);
```

**updateUser(INT $user\_id, ARR $update\_data)** - Update an existing User profile identified by $user\_id, returns an updated User object

```
$user_id = 12770260;

$update_data = array(
    'objective' => 'To improve my career a great deal.',
);

$obj_user = $tc->updateUser($user_id, $update_data);
```

### Circle Functions

[](#circle-functions)

**getCircle(INT $circle\_id)** - Get a single Circle object for the circle identified by $circle\_id

```
$circle_id = 375;
$obj_circle = $tc->getCircle($circle_id);
```

**getCircles(ARR $circle\_ids)** - Get an array of Circle objects for circles identified by an array of $circle\_ids

```
$circle_ids = array(
    372,
    375
);
$ar_circles = $tc->getCircles($circle_ids);
```

**getCircleJobs(INT $circle\_id, INT $offset, INT $limit)** - Get an array of Job objects posted to the circle identified by $circle\_id

```
$circle_id = 375;
$result_offset = 0;
$result_limit = 10;
$ar_jobs = $tc->getCircleJobs($circle_id, $result_offset, $result_limit);
```

**getCircleMembers(INT $circle\_id)** - Get an array of User objects for members of the circle identified by $circle\_id

```
$circle_id = 375;
$ar_members = $tc->getCircleMembers($circle_id);
```

**createCircle(ARR $circle\_data)** - Create a new Circle, returns a Circle object

```
$circle_data = array(
    'circle_name' => 'An Okay Test Circle',
    'owner_id' => 10961800
);
$obj_circle = $tc->createCircle($circle_data);
```

**postCircleStory(INT $circle\_id, ARR $story\_data)** - Post a new Story to the Circle identified by $circle\_id, returns a Circle object

```
$circle_id = 375;
$story_details = array(
        'title' => 'A New Test Story',
        'story' => 'This story is really, really new.'
);

$obj_story = $tc->postCircleStory($circle_id, $story_details);
```

**updateCircle(INT $circle\_id, ARR $update\_data)** - Update an existing Circle identified by $circle\_id, returns a updated Circle object

```
$circle_id = 384;
$update_data = array(
    'circle_name' => 'Great Test Circle',
);
$obj_circle = $tc->updateCircle($circle_id, $update_data);
```

### Story Functions

[](#story-functions)

**getStory(INT $story\_id)** - Get a single Story object for the story post identified by $story\_id

```
$story_id = 196;
$obj_story = $tc->getStory($story_id);
```

**getStories(ARR $story\_ids)** - Get multiple Story objects for story posts identified by an array of $story\_ids

```
$story_ids = array(
    196,
    197
);
$ar_stories = $tc->getStories($story_ids);
```

**postStory(ARR $story\_data)** - Post a new story to a Circle, returns the Story object

```
$story_data = array(
    'title' => 'A new test story ' . date("U"),
    'story' => 'This test story is really new.',
    'circle_id' => $circle_id
);
$obj_story = $tc->postStory($story_data);
```

This function can also be used to post a new Story to multiple Circles by passing an array of $circle\_ids into the 'circle\_id' element of the $story\_data array

```
$circle_ids = array(
    375,
    376
);
$story_data = array(
    'title' => 'Multiple Circle Test Story',
    'story' => 'This test story is being posted to two different circles.',
    'circle_id' => $circle_ids
);

$ar_stories = $tc->postStory($story_data);
```

**updateStory(INT $story\_id, ARR $story\_data)** - Update an existing Story post identified by $story\_id, returns the updated Story object

```
$story_id = 240;
$story_data = array(
    'story' => 'The text of this story is being updated.',
);
$obj_story = $tc->updateStory($story_id, $story_data);
```

**updateStories(ARR $story\_ids, ARR $story\_data)** - Update a set of existing Stories identified by an array of $story\_ids, returns an array of the updated Story objects

```
$story_ids = array(
    240,
    241
);
$story_data = array(
    'story' => 'The text of this story is being updated.',
);
$obj_story = $tc->updateStory($story_ids, $story_data);
```

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

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

Total

3

Last Release

3102d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/034a28274c8725bd52dbad6e03c6a08f27309a9e79794766e2d61852963d7735?d=identicon)[tcl0wers](/maintainers/tcl0wers)

---

Top Contributors

[![tclowers](https://avatars.githubusercontent.com/u/1098859?v=4)](https://github.com/tclowers "tclowers (11 commits)")

### Embed Badge

![Health badge](/badges/talentcircles-php-sdk/health.svg)

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

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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