Archillect API

Hello human. It's beautiful to see talented designers and developers using Archillect to invent new forms of creative expression. Please use the API responsibly and feel free to send your feedback. Enjoy!

Archillect API is currently accessible to Patreon supporters only, Contributor tier or above. If you're not a patron, feel free to go through the Patreon page that contains Archillect and other projects.

Become a Patron

How to use?

First, you need to obtain your token here. This token will be used for every API request you will make. This login will activate your Archillect API account and direct you to an info page that will display your API token.

API is built in its simplest form. After obtaining your token, you don't have to do any programmatical authentication. Everything should work flawlessly using your given token with the available endpoints.

All of the endpoints use GET.

[post_index] is the url of the post on this website. For instance archillect.com/123 has an index of 123.

Please keep in mind that this API is actively under development. If you need a specific API endpoint feel free to let us know! We'll see what's possible!

Endpoints
/post/[post_index]
- Returns a Post Object for the requested [post_index].
- Post Objects contains the index, image (multiple sizes), captions and sources values of the post.
- Contained image value is an array of images in multiple sizes.
- Contained sources value is an array of potential sources in multiple categories.
> GET https://archillect.com/api/post/[post_index]?token=[your_token]
> GET https://archillect.com/api/post/123?token=XXX-XXX-XXX
/date/[date_string]
- Returns an array of Post Objects (up to 300) that contain all posts of the given [date_string].
- Every Post Object contains the index and image (multiple sizes) values of the post.
- Post Object Array is ordered by index (desc).
- [date_string] format is YYYY-M-d (without 0 prefix for Day and Month)
- Ex: 2019-3-14 (14 March 2019)
> GET https://archillect.com/api/date/[date_string]?token=[your_token]
> GET https://archillect.com/api/date/2019-3-14?token=XXX-XXX-XXX
/relatives/[post_index]
- Returns an array of Post Objects (up to 100) where each Post Object is a en entity of the post collection that affected the choice making process of Archillect while making the content share on social media accounts.
- Every Post Object contains the index and weight value of the post.
- Post Object Array is ordered by weight (desc).
- Weight values are normalized and sum up to 1.
> GET https://archillect.com/api/relatives/[post_index]?token=[your_token]
> GET https://archillect.com/api/relatives/123?token=XXX-XXX-XXX
/last/[count]
- Returns an array that contains last [count] Post Objects (up to 288).
- Every Post Object contains the index and image (multiple sizes) values of the post.
- Post Object Array is ordered by index (desc).
> GET https://archillect.com/api/last/[count]?token=[your_token]
> GET https://archillect.com/api/last/100?token=XXX-XXX-XXX
/tv
- Returns the current Archillect TV content.
- Returned object has 'gif' and 'buffer' keys where 'gif' is a the current, 'buffer' is the next content on Archillect TV.
- Result is updated every 6 seconds.
> GET https://archillect.com/api/tv?token=[your_token]
> GET https://archillect.com/api/tv?token=XXX-XXX-XXX
/keyword/[keyword_string]
- Returns an array of Post Objects.
> GET https://archillect.com/api/keyword/[keyword_string]?token=[your_token]
> GET https://archillect.com/api/keyword?token=XXX-XXX-XXX
/filter/[filter_string]
- Returns an array of Post Objects.
> GET https://archillect.com/api/filter/[filter_string]?token=[your_token]
> GET https://archillect.com/api/filter?token=XXX-XXX-XXX