Firebase Firestore Import Actor

This actor imports data from an Apify dataset into a Firebase Firestore collection. It converts each dataset item into a Firestore document, handling the data transfer and transformation automatically.

Overview

The actor connects your Apify storage to Google's Firebase Firestore database. You provide your Firebase credentials and specify a source dataset and target collection. The actor then reads each item from the dataset and writes it as a document in Firestore. It's useful for migrating scraped or processed data into a live application database.

Key Features

• Direct Data Transfer: Moves data from an Apify dataset directly to a specified Firestore collection.
• Flexible Document IDs: You can use a unique field from your dataset as the Firestore document ID, or let Firestore auto-generate IDs.
• Custom Data Transformation: Optionally apply a JavaScript function to modify each data item before import.
• Automatic Collection Creation: If the specified Firestore collection doesn't exist, it will be created during the import.

How to Use

1. Configure the actor with your Firebase project credentials and target details.
2. Run the actor. It will fetch all items from your specified Apify dataset.
3. Each dataset item is processed (and transformed if specified) and written as a document to your Firestore collection.

Input Configuration

Configure the actor run with the following input fields:

Required Fields

• apiKey: Your Firebase Web API key. Find it in the Firebase console under Project settings > General.
• authDomain: Your Firebase auth domain. Found in the Firebase console when adding a web app (Project settings > Add app > Web app).
• projectId: Your Firebase project ID. Located in the Firebase console under Project settings > General.
• firestoreCollectionId: The name of the Firestore collection to import into. Find this in the Firestore Database > Data tab. Ensure Firestore rules permit write operations.
• datasetId: The ID of the Apify dataset to import from. Find this in the Apify console under Storage > Datasets.

Optional Fields

• customIdField: The name of a field in your dataset to use as the Firestore document ID. This field must contain unique values for each item, or documents will be overwritten. If left blank, Firestore auto-generates IDs.
• transformFunction: A custom JavaScript function to modify each data item before import. The function receives the dataset item as an argument and must return the modified object.

Transformation Function Example

function transform(item) {
    // Add a timestamp to each document
    item.importedAt = new Date().toISOString();
    // Rename a field
    item.processedTitle = item.title;
    delete item.title;
    return item;
}

Output

The actor's main output is the populated Firestore collection. Each document's content will match a transformed (or original) item from your Apify dataset. You can monitor the run execution and logs within the Apify platform.