DABBBLE API Documentation
Explore DABBBLE’s APIs and website embeds to bring current worktaster opportunities and events into your own projects.
These guides include endpoint details, response formats, organisation filters and code examples.
Get Started
Choose between APIs for custom integrations and website embeds for ready-made displays.
| Guide | What it provides | Best suited to |
|---|---|---|
| Worktaster API | Worktaster opportunity data in JSON format. | Building your own opportunity listings, cards or integrations. |
| Events API | Event data in JSON format. | Building your own event listings or connecting events to another application. |
| Worktaster Embed | Ready-made opportunity cards displayed through an iframe. | Adding worktasters to a website without building a custom interface. |
| Events Embed | Ready-made event cards displayed through an iframe. | Adding current events to a website with a small HTML snippet. |
All four support optional filtering by organisation. Public requests do not require an API key or account.
APIs
Use the JSON APIs when you want control over how data is displayed or processed.
Your application retrieves the data, then uses its own layout, styling and functionality.
Worktaster API
Retrieve current, published worktaster opportunities.
The response includes:
- Opportunity titles and organisation names.
- Descriptions and images.
- Attendance days and times.
- Start dates, end dates and application deadlines.
- Hourly rates and daily expenses.
- Skills, benefits and opportunity page links.
The guide explains the response fields, missing values, organisation filtering and PHP usage.
Events API
Retrieve current, published events, ordered by start date.
The response includes:
- Event titles and organisation names.
- Descriptions and images.
- Start and end dates.
- Event type values.
- Event page links.
The guide explains the JSON structure, organisation filtering, date formats, image fallbacks and error responses. It includes request examples and PHP snippets.
Website Embeds
Use an embed when you want to display DABBBLE content without building your own cards or fetching JSON yourself.
Paste an iframe into your page or your website builder’s custom HTML block. The embed supplies the card layout and styling.
Worktaster Embed
Display current worktaster opportunities in a responsive card layout.
The embed:
- Shows opportunity images, titles and organisation names.
- Displays attendance-based worktaster labels.
- Shows available application deadlines and start dates.
- Places the earliest application deadlines first.
- Links visitors to opportunity pages in a new tab.
- Supports filtering by organisation.
The guide includes a live demo, complete iframe examples, sizing options and details of empty and error states.
Read the Worktaster Embed guide
Events Embed
Display current events using the same responsive card style.
The embed:
- Shows event images, titles and organisation names.
- Displays available event type information.
- Shows start and end dates.
- Combines identical start and end date values into one date line.
- Places the earliest start dates first.
- Links visitors to event pages in a new tab.
- Supports filtering by organisation.
The guide includes a live demo, copy-ready iframe examples, responsive sizing and details of displayed information.
Filter by Organisation
Add org to an API or embed URL to request content from one organisation.
For example, show only DABBBLE events:
Or display those events in an embed:
Use the full organisation name and URL-encode spaces and special characters.
For Adventures + Wisdom Institute, the encoded value is:
Omit org to include all matching current content. Each guide explains its filtering behaviour and what happens when no records match.
Choose Your Integration
Build Your Own Display
Choose an API if you need to:
- Match your website’s design.
- Create custom cards, lists or other interfaces.
- Process records within your application.
- Control which fields visitors see.
Start with the relevant API guide, check the response fields and use the request examples to retrieve data.
Add a Ready-Made Display
Choose an embed if you need to:
- Add cards with a short HTML snippet.
- Avoid writing your own data-fetching code.
- Display one organisation’s opportunities or events.
- Use the existing DABBBLE card layout.
Start with the relevant embed guide, copy the iframe and adjust its width and height.
The cards adapt to the iframe’s width. The iframe itself uses the height you set and does not currently resize automatically to fit its contents.
Using These Docs
API Guides
Each API guide covers:
- Endpoint URLs and request examples.
- Supported query parameters.
- Example JSON responses.
- Response field names and data types.
- Missing values and date formats.
- PHP integration examples.
- HTTP status codes and error responses.
Embed Guides
Each embed guide covers:
- A live demonstration.
- HTML snippets for your website.
- Organisation filtering.
- Width and height adjustments.
- Mobile and desktop layouts.
- Sorting and displayed information.
- Empty and loading-failure messages.
- Customization options and limitations.
More Integrations
This documentation will expand as more DABBBLE APIs and embeds become available.
New API guides will appear in the APIs section. New ready-made displays will appear in Website Embeds.