How to load data from xkcd to BigQuery
Learn how to use Airbyte to synchronize your xkcd data into BigQuery within minutes.


Building your pipeline or Using Airbyte
Airbyte is the only open source solution empowering data teams to meet all their growing custom business demands in the new AI era.
Building in-house pipelines
- Inconsistent and inaccurate data
- Laborious and expensive
- Brittle and inflexible
After Airbyte
- Reliable and accurate
- Extensible and scalable for all your needs
- Deployed and governed your way
Start syncing with Airbyte in 3 easy steps within 10 minutes



Take a virtual tour
Demo video of Airbyte Cloud
Demo video of AI Connector Builder
Setup Complexities simplified!
Simple & Easy to use Interface
Airbyte is built to get out of your way. Our clean, modern interface walks you through setup, so you can go from zero to sync in minutes—without deep technical expertise.
Guided Tour: Assisting you in building connections
Whether you’re setting up your first connection or managing complex syncs, Airbyte’s UI and documentation help you move with confidence. No guesswork. Just clarity.
Airbyte AI Assistant that will act as your sidekick in building your data pipelines in Minutes
Airbyte’s built-in assistant helps you choose sources, set destinations, and configure syncs quickly. It’s like having a data engineer on call—without the overhead.
What sets Airbyte Apart
Modern GenAI Workflows
Streamline AI workflows with Airbyte: load unstructured data into vector stores like Pinecone, Weaviate, and Milvus. Supports RAG transformations with LangChain chunking and embeddings from OpenAI, Cohere, etc., all in one operation.
Move Large Volumes, Fast
Quickly get up and running with a 5-minute setup that enables both incremental and full refreshes for databases of any size, seamlessly scaling to handle large data volumes. Our optimized architecture overcomes performance bottlenecks, ensuring efficient data synchronization even as your datasets grow from gigabytes to petabytes.
An Extensible Open-Source Standard
More than 1,000 developers contribute to Airbyte’s connectors, different interfaces (UI, API, Terraform Provider, Python Library), and integrations with the rest of the stack. Airbyte’s AI Connector Builder lets you edit or add new connectors in minutes.
Full Control & Security
Airbyte secures your data with cloud-hosted, self-hosted or hybrid deployment options. Single Sign-On (SSO) and Role-Based Access Control (RBAC) ensure only authorized users have access with the right permissions. Airbyte acts as a HIPAA conduit and supports compliance with CCPA, GDPR, and SOC2.
Fully Featured & Integrated
Airbyte automates schema evolution for seamless data flow, and utilizes efficient Change Data Capture (CDC) for real-time updates. Select only the columns you need, and leverage our dbt integration for powerful data transformations.
Enterprise Support with SLAs
Airbyte Self-Managed Enterprise comes with dedicated support and guaranteed service level agreements (SLAs), ensuring that your data movement infrastructure remains reliable and performant, and expert assistance is available when needed.
What our users say

Raman Singh
Predictable, straightforward pricing model that simplified budgeting and significantly reduced overall spend

Chase Zieman

“Airbyte helped us accelerate our progress by years, compared to our competitors. We don’t need to worry about connectors and focus on creating value for our users instead of building infrastructure. That’s priceless. The time and energy saved allows us to disrupt and grow faster.”

Rupak Patel
"With Airbyte, we could just push a few buttons, allow API access, and bring all the data into Google BigQuery. By blending all the different marketing data sources, we can gain valuable insights."
How to Sync to Manually
Step 1: Understand xkcd Data Structure
Begin by exploring xkcd's data structure. xkcd comics are accessible via a JSON API at `https://xkcd.com/info.0.json` for the latest comic or `https://xkcd.com/[comic_number]/info.0.json` for specific comics. Understand the JSON response structure, which typically includes fields like "month," "num," "link," "year," "news," "safe_title," "transcript," "alt," "img," and "title."
Step 2: Set Up Your Google Cloud Project
Log into your Google Cloud Platform account and create a new project (if you don't have one already). Enable the BigQuery API for this project by navigating to the APIs & Services dashboard, clicking on "Enable APIs and Services," and searching for "BigQuery API."
Step 3: Prepare Your Local Environment
Ensure you have Python installed on your local machine along with the Google Cloud SDK, which provides the `gcloud` command-line tool. Additionally, install the `google-cloud-bigquery` library using pip:
```bash
pip install google-cloud-bigquery
```
Step 4: Extract Data from xkcd
Write a Python script that fetches data from the xkcd API. You can use the `requests` library to make HTTP requests. Loop through a range of comic numbers to fetch multiple comics, or start from the latest and work backward:
```python
import requests
def fetch_xkcd_data(comic_number):
url = f"https://xkcd.com/{comic_number}/info.0.json"
response = requests.get(url)
if response.status_code == 200:
return response.json()
else:
return None
# Example to fetch data for comic number 1
comic_data = fetch_xkcd_data(1)
```
Step 5: Transform Data for BigQuery
Convert the fetched JSON data into a format suitable for BigQuery. Flatten the JSON structure if necessary and create a list of dictionaries where each dictionary corresponds to one row of data:
```python
def transform_data(comic_data):
# Example transformation
return {
"comic_number": comic_data.get("num"),
"title": comic_data.get("title"),
"img_url": comic_data.get("img"),
"alt_text": comic_data.get("alt"),
"year": int(comic_data.get("year")),
"month": int(comic_data.get("month"))
}
transformed_data = transform_data(comic_data)
```
Step 6: Load Data into BigQuery
Use the BigQuery Python client library to load data into BigQuery. First, create a dataset and a table if they don’t exist. Then, insert the transformed data into the table:
```python
from google.cloud import bigquery
client = bigquery.Client()
dataset_id = 'your_dataset'
table_id = 'your_table'
dataset_ref = client.dataset(dataset_id)
table_ref = dataset_ref.table(table_id)
# Create dataset and table if not exists
client.create_dataset(dataset_ref, exists_ok=True)
schema = [
bigquery.SchemaField("comic_number", "INTEGER"),
bigquery.SchemaField("title", "STRING"),
bigquery.SchemaField("img_url", "STRING"),
bigquery.SchemaField("alt_text", "STRING"),
bigquery.SchemaField("year", "INTEGER"),
bigquery.SchemaField("month", "INTEGER")
]
table = bigquery.Table(table_ref, schema=schema)
client.create_table(table, exists_ok=True)
# Insert data
errors = client.insert_rows_json(table, [transformed_data])
if errors:
print(f"Encountered errors while inserting rows: {errors}")
```
Step 7: Verify Data in BigQuery
Finally, verify that the data was successfully loaded into BigQuery. Use the BigQuery console or the `bq` command-line tool to query your table and ensure the data appears as expected:
```bash
bq query --nouse_legacy_sql 'SELECT * FROM `your_project.your_dataset.your_table` LIMIT 10'
```
By following these steps, you should be able to extract data from xkcd, transform it, and load it into BigQuery without using any third-party connectors or integrations.