Skip to main content

XKCD

This page describes the setup guide and reference information for the XKCD source connector.

Prerequisites

XKCD provides a public JSON API. You don't need credentials to set up this source.

Setup guide

  1. Add a new XKCD source.
  2. For Comic Number, enter the first comic number to replicate. The connector starts with this comic and requests each following comic until no more comic metadata is available.

Supported sync modes

The XKCD source connector supports full refresh syncs. Incremental syncs aren't supported.

Supported streams

The connector syncs one stream:

StreamDescription
xkcdComic metadata from the XKCD JSON API, including comic number, title, post date, image URL, transcript, and alt text.

Performance considerations

The connector sends one request for each comic it reads, starting with the configured comic number. Larger backfills require more requests.

IP allow list

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference

This connector uses the XKCD JSON API. Requests use the https://xkcd.com endpoint.

For programmatic configuration, use this parameter name:

FieldRequiredDescription
comic_numberNoFirst comic number to replicate. Defaults to 2960.

Reference

Config fields reference

Field
Type
Property name
string
comic_number

Changelog

Expand to review
VersionDatePull RequestSubject
0.2.412026-05-2778454Update dependencies
0.2.402026-04-2877482Update dependencies
0.2.392026-04-2176803Update dependencies
0.2.382026-03-1775100Update dependencies
0.2.372026-03-1074666Update dependencies
0.2.362026-02-2473891Update dependencies
0.2.352026-02-1773528Update dependencies
0.2.342026-02-1073152Update dependencies
0.2.332026-02-0372089Update dependencies
0.2.322026-01-1471712Update dependencies
0.2.312025-12-1870711Update dependencies
0.2.302025-11-2570126Update dependencies
0.2.292025-11-1869517Update dependencies
0.2.282025-10-2968956Update dependencies
0.2.272025-10-2168446Update dependencies
0.2.262025-10-1467936Update dependencies
0.2.252025-10-0767318Update dependencies
0.2.242025-09-3066447Update dependencies
0.2.232025-09-0965734Update dependencies
0.2.222025-08-2465427Update dependencies
0.2.212025-08-1064865Update dependencies
0.2.202025-08-0264317Update dependencies
0.2.192025-07-2764089Update dependencies
0.2.182025-07-2063660Update dependencies
0.2.172025-07-1263193Update dependencies
0.2.162025-07-0561236Update dependencies
0.2.152025-05-2460764Update dependencies
0.2.142025-05-1060013Update dependencies
0.2.132025-05-0459557Update dependencies
0.2.122025-04-2658935Update dependencies
0.2.112025-04-1958563Update dependencies
0.2.102025-04-1358051Update dependencies
0.2.92025-04-0557393Update dependencies
0.2.82025-03-2956892Update dependencies
0.2.72025-03-2256251Update dependencies
0.2.62025-03-0855605Update dependencies
0.2.52025-03-0155116Update dependencies
0.2.42025-02-2254508Update dependencies
0.2.32025-02-1547934Update dependencies
0.2.22024-08-1644196Bump source-declarative-manifest version
0.2.12024-07-2842834Fix Metadata sha256 digest
0.2.02024-07-2542479Migrate to low code manifest only connector
0.1.102024-07-2042380Update dependencies
0.1.92024-07-1341682Update dependencies
0.1.82024-07-1041393Update dependencies
0.1.72024-07-0941204Update dependencies
0.1.62024-07-0640817Update dependencies
0.1.52024-06-2540389Update dependencies
0.1.42024-06-2240164Update dependencies
0.1.32024-06-0639293[autopull] Upgrade base image to v1.2.2
0.1.22024-05-2038401[autopull] base image + poetry + up_to_date
0.1.12022-10-2418386Readded xkcd to source def yaml
0.1.02022-10-1718049Initial version/release of the connector.