# Crustdata

```json
{
  "name": "Crustdata",
  "slug": "crustdata",
  "url": "https://composio.dev/toolkits/crustdata",
  "markdown_url": "https://composio.dev/toolkits/crustdata.md",
  "logo_url": "https://logos.composio.dev/api/crustdata",
  "categories": [
    "marketing & social media"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:07:51.622Z"
}
```

![Crustdata logo](https://logos.composio.dev/api/crustdata)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Crustdata MCP or direct API to enrich contacts, track company signals, discover leads, and monitor real-time B2B data through natural language.

## Summary

CrustData is an AI-powered data intelligence platform for real-time company and people data. It helps B2B sales teams, AI SDRs, and investors react to live business signals.

## Categories

- marketing & social media

## Toolkit Details

- Tools: 14

## Images

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

## Authentication

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

## Suggested Prompts

- Find tech companies with recent funding milestones
- Enrich this lead's profile with latest data
- List top decision makers in SaaS startups
- Fetch job listings for Fortune 500 companies

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `CRUSTDATA_ENRICH_PERSON_SCREENER` | Enrich person screener | The screener_person_enrich endpoint enriches person data by providing additional information based on the given query. It allows users to retrieve detailed information about individuals, which can be useful for various purposes such as customer profiling, lead generation, or data verification. This endpoint should be used when you need to augment existing person data with additional details or verify information about a specific individual. The enrichment process draws from CrustData's extensive database and real-time data sources to provide up-to-date and comprehensive information. Users can customize the response by specifying the exact fields they need, optimizing data transfer and processing. Note that the availability and accuracy of enriched data may vary depending on the input provided and the information available in CrustData's systems. |
| `CRUSTDATA_FETCH_HEADCOUNT_BY_FACET_TIMESERIES` | Fetch headcount by facet timeseries | Retrieves headcount data as a timeseries with faceted analysis capabilities. This endpoint allows users to fetch detailed headcount information over time, applying complex filters, pagination, and sorting. It's particularly useful for HR analytics, workforce planning, and organizational growth analysis. The endpoint supports nested logical operations in its filtering mechanism, enabling highly specific queries. Users can paginate through large datasets and sort results based on multiple criteria. While powerful, this endpoint requires careful construction of the filters parameter to ensure accurate data retrieval. It should be used when detailed, time-based headcount analysis is needed, but may not be suitable for simple, non-time-series headcount queries or for real-time data needs due to its complexity. |
| `CRUSTDATA_FETCH_INVESTOR_PORTFOLIO_DATA` | Fetch investor portfolio data | Retrieves comprehensive investor portfolio data from the Data Lab section of the CrustData API. This endpoint provides access to detailed information about investor portfolios, including investment holdings, performance metrics, and other relevant data points. It is designed to support investment analysis, portfolio management, and decision-making processes in a B2B context. The endpoint should be used when detailed investor portfolio information is required for tasks such as investment screening, performance tracking, or generating analytical reports. It's important to note that this endpoint may not provide real-time data and the frequency of updates should be verified in the API documentation. Additionally, users should be aware of any data privacy and usage restrictions that may apply to the retrieved investor information. |
| `CRUSTDATA_FILTER_DECISION_MAKERS_DATA` | Filter decision makers data | Filters and retrieves decision maker data from the CrustData B2B SaaS integration platform based on complex criteria. This endpoint allows for advanced querying of decision maker information using a combination of filters, pagination, sorting, and title-based filtering. It's designed for scenarios where specific subsets of decision maker data need to be extracted or analyzed. The endpoint supports nested logical conditions in filters, enabling highly targeted data retrieval. Use this when you need to perform detailed analysis or reporting on decision makers across various organizations or industries. Note that the endpoint requires careful structuring of the request body to effectively utilize its advanced filtering capabilities. |
| `CRUSTDATA_POST_FUNDING_MILESTONE_TIME_SERIES_DATA` | Post funding milestone timeseries data | The FundingMilestoneTimeseries endpoint retrieves time-series data related to funding milestones for companies. It allows for complex querying of funding events over time, with flexible filtering, pagination, and sorting options. This endpoint is particularly useful for analyzing funding trends, comparing company funding histories, or tracking specific funding events across multiple organizations. The data returned is based on the specified filters and can be tailored to focus on particular time ranges, funding stages, or company characteristics. While it provides comprehensive funding milestone data, it does not include detailed company information beyond what's directly related to funding events. |
| `CRUSTDATA_POST_HEADCOUNT_TIMESERIES_DATA` | Post headcount timeseries data | Retrieves filtered and sorted headcount timeseries data from the CrustData Data Lab. This endpoint allows for complex querying of historical headcount information, enabling users to analyze workforce trends over time. It supports advanced filtering with nested conditions, pagination for handling large datasets, and customizable sorting. Ideal for generating reports, conducting workforce analysis, or integrating headcount data into third-party business intelligence tools. Note that the specifics of the returned data structure are not provided in the given schema. |
| `CRUSTDATA_POST_JOB_LISTINGS_TABLE_DATA` | Post job listings table data | This endpoint retrieves filtered and sorted job listings data for specified company tickers from a chosen dataset in the CrustData platform. It allows for highly customizable queries with complex filtering conditions, pagination, and sorting options. The endpoint is designed for bulk data retrieval and analysis of job market trends across multiple companies. Use this endpoint when you need to fetch and analyze job listing data for specific companies, apply custom filters to narrow down the results, or when you want to paginate through large sets of job data. It's particularly useful for market research, competitive analysis, or tracking employment trends in specific industries or companies. Note that this endpoint requires careful construction of the request body, especially for the filters parameter, which can support nested logical conditions. The performance and response time may vary depending on the complexity of the filters and the amount of data requested. |
| `CRUSTDATA_POST_WEB_TRAFFIC_DATA` | Post web traffic data | Retrieves filtered and sorted web traffic data from the CrustData platform. This endpoint allows for complex querying of web traffic information using nested conditions and logical operators. It supports pagination for handling large datasets and provides sorting capabilities for customized data presentation. Use this endpoint when you need to analyze web traffic patterns, filter data based on specific criteria, or extract insights from your web analytics. The endpoint is particularly useful for generating reports, identifying trends, or monitoring key performance indicators related to web traffic. |
| `CRUSTDATA_RETRIEVE_LINKED_IN_POSTS` | Retrieve linkedin posts | Retrieves LinkedIn posts for a specified company using CrustData's screener functionality. This endpoint allows users to gather social media data from LinkedIn, which can be used for analyzing company activity, engagement, and sentiment. It's particularly useful for B2B marketers, sales professionals, and analysts who need insights into a company's social media presence and content strategy. The endpoint supports filtering by date range and customizing the response fields, making it versatile for various use cases such as competitive analysis, lead generation, and market research. Note that the availability and completeness of data may depend on the company's LinkedIn activity and privacy settings. |
| `CRUSTDATA_SCREENER_COMPANY_INFORMATION` | Screener company information | The GetCompanyScreener endpoint allows users to search and filter companies based on various criteria such as headcount, growth rate, funding, and more. It provides a powerful way to identify specific companies that meet predefined conditions. This endpoint is particularly useful for tasks like lead generation, market research, and competitive analysis. The endpoint returns a list of companies matching the specified criteria, with each company entry containing key information such as name, industry, headcount, funding details, and growth metrics. Users can customize their search using multiple filters, sort the results, and paginate through large result sets. Note that the accuracy of the data depends on CrustData's real-time data collection and update frequency. |
| `CRUSTDATA_SCREEN_METRICS_AND_FILTER_CONDITIONS` | Screen metrics and filter conditions | The ScreenData endpoint enables advanced data screening and filtering on the CrustData platform. It allows users to construct complex queries for retrieving specific datasets based on custom metrics, filtering conditions, and sorting criteria. Use this endpoint for targeted data extraction, custom reporting, or data analysis within the B2B SaaS integration ecosystem. Note that while powerful, complex queries may impact performance with large datasets. |
| `CRUSTDATA_SEARCH_COMPANIES_WITH_FILTERS` | Search companies with filters | The CompanySearch endpoint enables users to search and filter companies using the CrustData API. It provides a powerful mechanism for querying company data based on multiple criteria, supporting complex filtering and pagination. This endpoint is ideal for applications that need to retrieve specific sets of company information, such as financial analysis tools, market research platforms, or business intelligence systems. The search functionality allows for precise data retrieval, enhancing the efficiency of data integration and analysis processes in B2B scenarios. Users should be aware that the endpoint requires careful construction of filter objects and proper use of pagination to ensure optimal performance and accurate results. |
| `CRUSTDATA_SEARCH_FOR_JOB_ID_IN_SCREENER` | Search for job id in screener | The screener_person_search endpoint allows users to search for persons associated with a specific job ID within the CrustData B2B SaaS integration platform. This POST request accepts a JSON payload containing a job_id and returns relevant person data linked to that job. It's particularly useful for scenarios where you need to quickly retrieve all individuals connected to a particular job or project. The endpoint is part of the platform's screening functionality, enabling efficient filtering of person records based on job-related criteria. While it provides a focused search based on job ID, it may not offer advanced filtering options or return comprehensive job details. |
| `CRUSTDATA_SEARCH_LINKED_IN_POSTS_BY_KEYWORD` | Search linkedin posts by keyword | This endpoint enables searching for LinkedIn posts using a specific keyword. It allows users to retrieve relevant content from LinkedIn by specifying a search term, along with options for pagination, sorting, and filtering by post date. The function is particularly useful for conducting market research, competitor analysis, or tracking industry trends on the LinkedIn platform. Users can fine-tune their search results by choosing how to sort the posts (by relevance or date) and selecting a specific time frame for the content. The endpoint returns paginated results, allowing for efficient navigation through large sets of matching posts. |

## 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 Crustdata Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Crustdata actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Find recent funding rounds for SaaS companies in Germany'
  }]
)
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: 'Find recent funding rounds for SaaS companies in Germany'
  }],
});
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 Crustdata tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Find decision makers at SaaS companies in Germany with over 100 employees')
        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: 'Find decision makers at SaaS companies in Germany with over 100 employees' }],
  stopWhen: stepCountIs(5)
});

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

## Why Use Composio?

### 1. AI Native Crustdata Integration

- Supports both Crustdata MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Crustdata data

### 2. Managed Auth

- Built-in API key handling with secure storage
- Central place to manage, scope, and revoke Crustdata access
- 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 Crustdata
- Scoped, least privilege access to Crustdata resources
- Full audit trail of agent actions to support review and compliance

## Use Crustdata with any AI Agent Framework

Choose a framework you want to connect Crustdata with:

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

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Campayn](https://composio.dev/toolkits/campayn) - Campayn is an email marketing platform for creating, sending, and managing campaigns. It helps businesses engage contacts and grow audiences with easy-to-use tools.
- [Cardly](https://composio.dev/toolkits/cardly) - Cardly is a platform for creating and sending personalized direct mail to customers. It helps businesses break through the digital clutter by getting real engagement via physical mailboxes.
- [ClickSend](https://composio.dev/toolkits/clicksend) - ClickSend is a cloud-based SMS and email marketing platform for businesses. It streamlines communication by enabling quick message delivery and contact management.
- [Curated](https://composio.dev/toolkits/curated) - Curated is a platform for collecting, curating, and publishing newsletters. It streamlines content aggregation and distribution for creators and teams.
- [Customerio](https://composio.dev/toolkits/customerio) - Customer.io is a customer engagement platform for targeted messaging across email, SMS, and push. Easily automate, segment, and track communications with your audience.
- [Cutt ly](https://composio.dev/toolkits/cutt_ly) - Cutt.ly is a URL shortening service for managing and analyzing links. Streamline your workflows with quick, trackable, and branded short URLs.
- [Demio](https://composio.dev/toolkits/demio) - Demio is webinar software built for marketers, offering both live and automated sessions with interactive features. It helps teams engage audiences and optimize lead generation through detailed analytics.
- [Doppler marketing automation](https://composio.dev/toolkits/doppler_marketing_automation) - Doppler marketing automation is a platform for creating, sending, and tracking email campaigns. It helps you automate marketing workflows and manage subscriber lists for better engagement.

## Frequently Asked Questions

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

Yes, Crustdata 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)