# Diffbot

```json
{
  "name": "Diffbot",
  "slug": "diffbot",
  "url": "https://composio.dev/toolkits/diffbot",
  "markdown_url": "https://composio.dev/toolkits/diffbot.md",
  "logo_url": "https://logos.composio.dev/api/diffbot",
  "categories": [
    "data & analytics"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:08:44.324Z"
}
```

![Diffbot logo](https://logos.composio.dev/api/diffbot)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Diffbot MCP or direct API to extract article content, analyze product listings, enrich structured web data, and automate web research through natural language.

## Summary

Diffbot is an AI-powered platform for extracting and structuring data from any web page. It transforms unstructured web content into rich, linked, and queryable data for analytics, research, and automation.

## Categories

- data & analytics

## Toolkit Details

- Tools: 35

## Images

- Logo: https://logos.composio.dev/api/diffbot

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Diffbot.
  - Setup:
    - Configure Api Key credentials for Diffbot.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Extract specs and reviews from a product page
- Summarize key details from a news article URL
- List all bulk data extraction jobs for my account
- Get discussion threads from a forum post link

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `DIFFBOT_COMBINE_ENTITY_PROFILES` | Combine Entity Profiles | Combine multiple entity profiles into a unified view using the Diffbot Knowledge Graph. Returns enhanced person or organization data by matching on identifying attributes like name, email, employer, or URL. Use this to enrich partial entity data, merge duplicate profiles, or verify entity identity. |
| `DIFFBOT_CREATE_BULK` | Create Bulk Extract Job | Tool to submit a bulk extract job to process multiple URLs with Extract APIs. Use when you need to process many URLs asynchronously using any Extract API. The job will process URLs in the background and provide downloadable results. |
| `DIFFBOT_CREATE_CUSTOM_API` | Create or Update Custom API | Tool to create or update the parameters and ruleset of a Custom API. Use this when you need to define custom extraction rules for specific websites that require tailored parsing logic beyond standard Diffbot APIs. Allows defining URL patterns, CSS selectors, extraction rules, and preprocessing filters to extract structured data from websites with unique layouts. |
| `DIFFBOT_CREATE_KG_BULK_ENHANCE` | Create Bulk Enhance Job | Tool to submit a bulk enhance job to enrich multiple entities asynchronously. Use when you need to process many Person or Organization records in batch. The API accepts entity descriptions and returns enriched data from the Diffbot Knowledge Graph. |
| `DIFFBOT_DELETE_CUSTOM_API` | Delete Custom API | Tool to delete custom API definitions for a given URL pattern. Removes custom extraction rules from your account. Use when you need to remove previously configured custom APIs. |
| `DIFFBOT_DELETE_KG_ENHANCE_BULKJOB` | Delete KG Enhance Bulkjob | Tool to delete an Enhance Bulkjob. Removes the bulk job and its results from the system. Use when cleaning up completed or failed jobs. |
| `DIFFBOT_DOWNLOAD_BULK_RESULTS` | Download Bulk Job Results | Tool to download results of a bulk enhance job with filtering options via POST request. Use this to retrieve processed results from a completed or running bulk job. Supports multiple export formats (json, jsonl, csv, xls, xlsx) and various filtering options to customize the output. HTTP 200 indicates results are ready, HTTP 201 means the job is still executing. |
| `DIFFBOT_ENHANCE_ENTITY` | Enhance Entity with Knowledge Graph | Enrich a person or organization with comprehensive data from the Diffbot Knowledge Graph. Provide identifiers like name, email, employer, or URL and receive detailed entity information including employment history, education, location, skills, and more. Use when you need to gather all publicly available knowledge about a specific person or organization from billions of web pages. |
| `DIFFBOT_EXTRACT_JOB` | Diffbot Extract Job | Tool to extract structured job posting data from job listing pages. Returns job title, company, location, salary, requirements, skills, and other job-related information. Use when you need to parse and structure data from job postings. |
| `DIFFBOT_EXTRACT_LIST` | Diffbot Extract List | Tool to extract structured data from list-style pages like news indexes, product listings, and directory pages. Returns an array of items with their titles, links, and descriptions. Use when you need to extract multiple items from a page organized as a list or index. |
| `DIFFBOT_GET_ACCOUNT` | Get Diffbot Account Details | Retrieves comprehensive Diffbot account information including subscription plan details, credit balance, usage history, and account status. Returns account holder name, email, current plan, available credits, and daily usage statistics for the past 31 days. Use this to check your account's credit balance, monitor API usage patterns, verify account status, or retrieve account metadata. |
| `DIFFBOT_GET_ANALYZE` | Diffbot Analyze | Automatically analyzes a web page to determine its type and extract structured data. The Analyze API intelligently classifies pages into types (article, product, discussion, image, video, organization, etc.) and extracts relevant structured data. Use this when you need to process URLs of unknown type or want automatic extraction without specifying the page type in advance. |
| `DIFFBOT_GET_ARTICLE` | Get Article Data | Tool to extract information from articles, including authors, publication dates, and images. Use when you need structured metadata from a web article URL. |
| `DIFFBOT_GET_BULK_DATA` | Get Bulk Job Data | Tool to download extracted results from a completed bulk job. Use after a bulk job has finished processing to retrieve the data. Supports JSON and CSV formats. |
| `DIFFBOT_GET_BULK_JOB_STATUS` | Get Bulk Job Status | Tool to poll the status of a specific Diffbot Knowledge Graph Enhance bulk job. Use when you need to check the progress, completion status, or details of a bulk enhancement job. |
| `DIFFBOT_GET_BULK_RESULTS` | Get Bulk Job Results | Tool to download the results of a completed Enhance Bulkjob. Returns enriched records from the bulk job. Use after a bulk enhance job has completed processing. |
| `DIFFBOT_GET_BULK_SINGLE_RESULT` | Get Bulk Single Result | Tool to download the result of a single job within a Diffbot bulk enhance job. Returns enriched entity data for a specific input record by its index. Use after a bulk enhance job has completed to retrieve individual results without downloading the entire dataset. |
| `DIFFBOT_GET_CRAWL_DATA` | Get Crawl Data | Download extracted results from a completed crawl job. Returns all structured data extracted during crawl processing (articles, products, etc.). Use after a crawl job has completed to retrieve the collected data. |
| `DIFFBOT_GET_DISCUSSION` | Get Discussion Thread | Extract structured discussion threads from web pages including forums, comment sections, product reviews, Reddit discussions, and blog comments. Returns posts with author info, timestamps, content, and hierarchical relationships. Useful for analyzing conversations, gathering feedback, or monitoring discussions. Supported platforms: Native comment systems, Disqus, Facebook Comments, Reddit, forum software, and more. Use this when you need to: - Extract all comments/posts from a discussion thread - Analyze user feedback or reviews - Monitor forum discussions or social media threads - Gather structured conversation data with metadata |
| `DIFFBOT_GET_EVENT` | Diffbot Get Event | Tool to extract event details from web pages. Use when you need structured event data such as venue, date, and description. |
| `DIFFBOT_GET_IMAGE` | Diffbot Get Image | Tool to extract detailed information about images, including dimensions and recognition data. Use after confirming the image URL is publicly accessible. |
| `DIFFBOT_GET_KG_COVERAGE_REPORT_BY_ID` | Get KG Coverage Report by ID | Download Knowledge Graph coverage report by report ID. Returns detailed CSV coverage statistics showing field presence across query results. Use this after generating a coverage report from a DQL query to retrieve the statistical breakdown of field coverage. |
| `DIFFBOT_GET_PRODUCT` | Diffbot Get Product | Tool to extract product information such as specifications, prices, availability, and reviews. Use when you need structured product data including specs, pricing, and reviews. |
| `DIFFBOT_GET_VIDEO` | Get Video Data | Tool to extract information from videos, including titles, descriptions, and embedded HTML. Use when you need structured video metadata from any web page. |
| `DIFFBOT_LIST_BULK_JOBS` | List Bulk Jobs | Tool to list all Bulk jobs associated with a specific token. Use after authenticating to retrieve statuses of all jobs for the account. |
| `DIFFBOT_LIST_BULK_JOBS_STATUS_FOR_TOKEN` | List Bulk Jobs Status For Token | Tool to get the status of all bulk enhance jobs for a token. Returns list of all bulk jobs associated with your API token. Use when you need to monitor or retrieve the status of multiple bulk jobs at once. |
| `DIFFBOT_LIST_CUSTOM_APIS` | List Custom APIs | Tool to retrieve all Custom APIs and their extraction rules currently defined on your Diffbot token. Use when you need to list, review, or audit custom API configurations for your account. |
| `DIFFBOT_MANAGE_CRAWL` | Manage Crawl Job | Manages Diffbot crawl jobs: pause, restart, delete, or view status. Returns list of all active crawl jobs when called without parameters. Use 'name' parameter with action flags (pause=1, restart=1, delete=1) to control specific jobs. |
| `DIFFBOT_RESOLVE_LOST_ID` | Resolve Lost ID | Tool to resolve lost IDs in the Knowledge Graph. Use when you need to map a lost identifier to its canonical counterpart for data consistency. |
| `DIFFBOT_SEARCH` | Diffbot Knowledge Graph Search | Search the Diffbot Knowledge Graph using DQL (Diffbot Query Language). Query billions of entities including organizations, people, articles, products, and more. Use structured queries to filter by type, fields, and relationships. |
| `DIFFBOT_SEARCH_CRAWL_DATA` | Search Crawl Job Data | Tool to query crawl job collections using DQL (Diffbot Query Language). Use when you need to search extracted data from completed crawl or bulk jobs by collection name. |
| `DIFFBOT_START_BULK` | Start Bulk Job | Tool to start a Bulk Extract job. Use when processing large numbers of URLs asynchronously. The Diffbot Bulk API uses GET requests with query parameters to create jobs. |
| `DIFFBOT_START_CRAWL` | Start Crawl Job | Initiates a Diffbot crawl job that spiders a website starting from seed URLs and processes discovered pages with a specified Extract API. The crawler follows links within the domain, collects structured data (articles, products, etc.), and stores results for download. Use this to systematically extract data from entire websites or sections. Requires Diffbot Plus plan or higher. |
| `DIFFBOT_STOP_BULK_JOB` | Stop Bulk Job | Tool to pause (stop) a running Bulk job. Pausing halts further processing of URLs while preserving existing progress. To resume, use the appropriate resume action. Specify the exact job name (case-sensitive) as provided when the job was created. |
| `DIFFBOT_STOP_KG_BULK_JOB_BY_ID` | Stop KG Bulk Job By ID | Tool to stop an active Knowledge Graph Enhance bulk job by its ID. Halts processing of a running KG bulk job immediately. Use when you need to stop a specific KG bulk job using its bulkjobId. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Diffbot Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Diffbot actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Extract product info from this Amazon page'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Extract product info from this Amazon page'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Diffbot tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Extract product details from https://www.example.com/product/12345')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Extract product details from https://www.example.com/product/12345' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Diffbot Integration

- Supports both Diffbot MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for extracting, analyzing, and enriching web data

### 2. Managed Auth

- Built-in API key management with secure storage and rotation
- Central place to manage, scope, and revoke Diffbot API keys
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Diffbot
- Scoped, least privilege access to Diffbot resources
- Full audit trail of agent actions to support review and compliance

## Use Diffbot with any AI Agent Framework

Choose a framework you want to connect Diffbot with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/diffbot/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/diffbot/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/diffbot/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/diffbot/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/diffbot/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/diffbot/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/diffbot/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/diffbot/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/diffbot/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/diffbot/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/diffbot/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/diffbot/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/diffbot/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/diffbot/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/diffbot/framework/autogen)

## Related Toolkits

- [Excel](https://composio.dev/toolkits/excel) - Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.
- [21risk](https://composio.dev/toolkits/_21risk) - 21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters.
- [Abstract](https://composio.dev/toolkits/abstract) - Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agentql](https://composio.dev/toolkits/agentql) - Agentql is a toolkit that connects AI agents to the web using a specialized query language. It enables structured web interaction and data extraction for smarter automations.
- [Agenty](https://composio.dev/toolkits/agenty) - Agenty is a web scraping and automation platform for extracting data and automating browser tasks—no coding needed. It streamlines data collection, monitoring, and repetitive online actions.
- [Ambee](https://composio.dev/toolkits/ambee) - Ambee is an environmental data platform providing real-time, hyperlocal APIs for air quality, weather, and pollen. Get precise environmental insights to power smarter decisions in your apps and workflows.
- [Ambient weather](https://composio.dev/toolkits/ambient_weather) - Ambient Weather is a platform for personal weather stations with a robust API for accessing local, real-time, and historical weather data. Get detailed environmental insights directly from your own sensors for smarter apps and automations.
- [Anonyflow](https://composio.dev/toolkits/anonyflow) - Anonyflow is a service for encryption-based data anonymization and secure data sharing. It helps organizations meet GDPR, CCPA, and HIPAA data privacy compliance requirements.
- [Api ninjas](https://composio.dev/toolkits/api_ninjas) - Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints.
- [Api sports](https://composio.dev/toolkits/api_sports) - Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots.
- [Apify](https://composio.dev/toolkits/apify) - Apify is a cloud platform for building, deploying, and managing web scraping and automation tools called Actors. It lets you automate data extraction and workflow tasks at scale—no infrastructure headaches.
- [Autom](https://composio.dev/toolkits/autom) - Autom is a lightning-fast search engine results data platform for Google, Bing, and Brave. Developers use it to access fresh, low-latency SERP data on demand.
- [Beaconchain](https://composio.dev/toolkits/beaconchain) - Beaconchain is a real-time analytics platform for Ethereum 2.0's Beacon Chain. It provides detailed insights into validators, blocks, and overall network performance.
- [Big data cloud](https://composio.dev/toolkits/big_data_cloud) - BigDataCloud provides APIs for geolocation, reverse geocoding, and address validation. Instantly access reliable location intelligence to enhance your applications and workflows.
- [Bigpicture io](https://composio.dev/toolkits/bigpicture_io) - BigPicture.io offers APIs for accessing detailed company and profile data. Instantly enrich your applications with up-to-date insights on 20M+ businesses.
- [Bitquery](https://composio.dev/toolkits/bitquery) - Bitquery is a blockchain data platform offering indexed, real-time, and historical data from 40+ blockchains via GraphQL APIs. Get unified, reliable access to complex on-chain data for analytics, trading, and research.
- [Brightdata](https://composio.dev/toolkits/brightdata) - Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction.
- [Builtwith](https://composio.dev/toolkits/builtwith) - BuiltWith is a web technology profiler that uncovers the technologies powering any website. Gain actionable insights into analytics, hosting, and content management stacks for smarter research and lead generation.
- [Byteforms](https://composio.dev/toolkits/byteforms) - Byteforms is an all-in-one platform for creating forms, managing submissions, and integrating data. It streamlines workflows by centralizing form data collection and automation.

## Frequently Asked Questions

### Do I need my own developer credentials to use Diffbot with Composio?

Yes, Diffbot requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)