Connect+ API Documentation

Connect+ is a powerful API that enhances your Notion workspace with AI-powered insights using Google's Gemini Pro model, seamlessly integrated with Zapier for workflow automation.

Our AI engine analyzes your Notion databases to provide actionable insights, detect patterns, and generate recommendations that would be impossible to see manually. Combine this with Zapier integration to create intelligent workflows that respond to your data.

Base URL

https://connect-plus-zapier.vercel.app/api

Authentication

All API endpoints require authentication using a Notion API key. The API key should be passed in the request headers.

HTTP Headers

{
  "x-notion-key": "your_notion_api_key"
}

Important

Keep your API key secure. Never expose it in client-side code or commit it to your repository.

Rate Limits

The Connect+ API enforces the same rate limits as the Notion API:

  • 3 requests per second per token
  • 90 requests per minute per token
  • 1,000 requests per day per token (non-partner integrations)

If you exceed these limits, the API will return a 429 (Too Many Requests) error.

Error Response Example

{
  "error": {
    "status": 429,
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after: 30 seconds"
  }
}

Notion Database Endpoints

GET/notion/database/{database_id}

Retrieve a database

Retrieves a Notion database by its ID.

Parameters

  • database_id - The ID of the database to retrieve

Response

{
  "structure": {
    "object": "database",
    "id": "database_id",
    "title": [...],
    "properties": {...},
    ...
  }
}
POST/notion/database/{database_id}/query

Query a database

Queries a Notion database, with optional filters and sorting.

Request Body

{
  "filter": {...},   // Optional
  "sorts": [...],    // Optional
  "page_size": 100,  // Optional
  "start_cursor": "cursor" // Optional for pagination
}

Response

{
  "object": "list",
  "results": [...],
  "next_cursor": "cursor",
  "has_more": true
}

AI Insights Endpoint Premium Feature

GET/notion/database/insights?database_id={database_id}

Get AI-powered insights with Gemini Pro

This endpoint harnesses the power of Google's Gemini Pro model to analyze your Notion database and provide intelligent insights that would be impossible to see manually.

Powered by Google's Gemini Pro

Pattern Recognition: Identifies patterns and trends in your data that humans might miss

Actionable Insights: Provides practical recommendations based on your database content

Data Summarization: Condenses large datasets into meaningful summaries

Performance Analysis: Evaluates metrics and suggests optimization opportunities

Parameters

  • database_id - The ID of the database to analyze

Response

{
  "database": {
    "structure": {...},
    "contents": {...}
  },
  "insights": {
    "summary": "A brief summary of the database contents",
    "insights": ["Key insight 1", "Key insight 2", ...],
    "patterns": ["Pattern 1", "Pattern 2", ...],
    "recommendations": ["Recommendation 1", "Recommendation 2", ...]
  }
}

Example Usage

curl -X GET 'https://connect-plus-zapier.vercel.app/api/notion/database/insights?database_id=YOUR_DATABASE_ID' \
  -H 'x-notion-key: your_notion_api_key'

Zapier Setup Guide

Follow these steps to set up Connect+ with Zapier:

Quick Access

Use our direct invite link to access the Connect+ integration:Connect+ on Zapier

1

Connect your Notion account

In Zapier, search for the Connect+ integration and connect your Notion account by providing your Notion API key.

2

Choose a trigger

Select an event from another app to trigger the Connect+ actions. For example, a new form submission, calendar event, or email.

3

Select a Connect+ action

Choose one of the Connect+ actions such as:

  • Query a database
  • Get database insights
4

Configure the action

Enter the required information such as the database ID or page ID, and map fields from your trigger to the action.

5

Test and activate

Test the Zap to ensure it works correctly, then turn it on to start automating your workflow.

AI-Powered Workflow Examples

Intelligent Data Analysis

Automatically analyze your Notion CRM database weekly and receive AI-powered insights about customer patterns.

ScheduleConnect+ AISlack

Form Submission Analysis

When new form submissions are added to your database, get automatic AI analysis of trends and sentiment.

Google FormsConnect+ AIEmail

Anomaly Detection

Get alerted when Gemini Pro detects unusual patterns or outliers in your financial database entries.

NotionConnect+ AISMS

Smart Content Calendar

Analyze your content performance data and get AI-recommended content ideas based on past success.

Notion DBConnect+ AIGoogle Docs

Gemini Pro-Powered Workflows

Google's Gemini Pro model unlocks powerful AI capabilities for your Notion databases:

  • Generate summaries of client feedback across multiple databases
  • Receive AI recommendations for process improvements based on project database analysis
  • Automatically categorize and tag incoming information using Gemini's classification abilities
  • Detect sentiment trends in customer feedback and alert stakeholders to emerging issues
  • Transform raw data into actionable reports with contextual understanding

Need further assistance? Check our GitHub issues or contact us.

© 2025 Half Dozen. All rights reserved.