Botwiki Site API

Botwiki offers access to its data with a free public API, utilizing the WordPress REST API. You can refer to the WP REST API documentation for more detailed information. Check out the tutorial section on Botwiki if you’re new to web APIs.

We’d love to see how you use our API, and welcome feedback and suggestions!



The base URL for getting bot information is:

Here’s a condensed example of the returned data:

    "date": "2018-01-23T14:22:56",
    "slug": "bartleby_scrvnr",
    "type": "bot",
    "link": "",
        "rendered": "@bartleby_scrvnr"
    "content":{ /* ... */ },
        "rendered": "I would prefer not to.",
    "tags_full": [
        "book character"
    "featured_image_url": "",
    "bot_urls": [
    "bot_source_urls": [
    "source_languages": [ /* ... */ ],
    "bot_author_info": [
        "Stefan Bohacek,"

By default, you will get 10 results, and you can go up to 100 by specifying the per_page attribute.

Then, to get the next page, use page, for example:

On top of the standard fields that WordPress shows, you will also find the following information:


WordPress returns the tags field as an array of tag IDs, but here you will also get the tag names with tags_full.

"tags_full": [

This is the URL of the bot page thumbnail. Example value:


An array of URLs where the bot is posting. Example value:



An array of URLs with the source code and/or the data used by the bot.



An array of WordPress terms designating the languages used in the bot’s source code. Here’s an example:

        term_id: 2223,
        name: 'Javascript',
        slug: 'javascript',
        term_group: 0,
        term_taxonomy_id: 2223,
        taxonomy: 'programing_language',
        description: '',
        parent: 0,
        count: 24,
        filter: 'raw'
        term_id: 1727,
        name: 'Tracery',
        slug: 'tracery',
        term_group: '0',
        term_taxonomy_id: 1727,
        taxonomy: 'programing_language',
        description: null  ,
        parent: 0,
        count: 120,
        filter: 'raw'


An array of authors with the format name, URL, where the URL is optional.

    'Stefan Bohacek,'

Searching by bot URL

You can pass the URL of a bot as the bot_url argument. For example, for @emoji__polls you could make the following request:

Filtering by tags

Use the tag attribute to filter bots by tags. Note that WordPress uses tags, which only accept numerical tag IDs.

You can also filter for multiple tags.,iot

Filtering open source bots

You can pass opensource=true in the URL to filter bots with a link to their source code.

Random bot with a specific tag

This example fetches one random bot tagged with emoji.[orderby]=rand&filter[posts_per_page]=1

More projects

Botwiki Browser Extension

A browser extension that adds a link to a bot's Botwiki entry on relevant pages.

Glitch-hosted fediverse bot

Bringing art bots back to the open web.


Sidekick makes Slack groups easier to manage and more enjoyable to be in.

Botwiki Interviews

Stories and thoughts of people who use automation for work and fun.

Browse all

Latest from the blog

2015-2018: The Golden Age of botmaking

Reminiscing and looking ahead.

Poll: The language of botmaking

To make a bot, or to author it?

Five years of Botwiki

Happy birthday, Botwiki!

Glitch banning use of pinging services

An end of an era, yet again.

Visit the blog

Enjoying Botwiki?

Consider supporting the project!