# HarvestAPI

```json
{
  "name": "HarvestAPI",
  "slug": "harvestapi",
  "url": "https://composio.dev/toolkits/harvestapi",
  "markdown_url": "https://composio.dev/toolkits/harvestapi.md",
  "logo_url": "https://logos.composio.dev/api/harvestapi",
  "categories": [
    "hr & recruiting"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-19T05:33:02.837Z"
}
```

![HarvestAPI logo](https://logos.composio.dev/api/harvestapi)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with HarvestAPI MCP or direct API to search LinkedIn people, find companies, enrich profiles, and enrich company records through natural language.

## Summary

HarvestAPI is a recruiting and lead intelligence service for LinkedIn people and company data.
It helps teams find prospects and enrich profiles with useful company insights.

## Categories

- hr & recruiting

## Toolkit Details

- Tools: 32

## Images

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

## Authentication

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

## Suggested Prompts

- Search LinkedIn for senior engineers in Austin
- Enrich a LinkedIn profile with company data
- Find companies hiring data scientists in Boston

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `HARVESTAPI_GET_ACCOUNT_INSIGHTS` | Get LinkedIn Account Insights | Get broad LinkedIn company intelligence including company and revenue data, AI-generated sourced summaries, competitors, key people, headcount, hiring, news, suggested contacts, and alerts. Generated summaries are not verified facts. This provider-scraping read can return identifiable executives, leads, posts, and relationship signals; billing, credit use, and account-tier behavior are unverified. |
| `HARVESTAPI_GET_AD` | Get LinkedIn Ad | Get detailed creative, advertiser, impression, and targeting data for one LinkedIn ad. Callers can provide an ID or URL. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_COMMENT_REACTIONS` | Get LinkedIn Comment Reactions | Get one page of reactions to a LinkedIn comment. This provider-scraping read returns reactors' profile identity and position; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_COMPANY` | Get LinkedIn Company | Enrich one LinkedIn company by company URL, universal name, or company ID. This is a provider-scraping read; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_COMPANY_PEOPLE_STATS` | Get LinkedIn Company People Stats | Return aggregate LinkedIn employee distributions for a company across location, school, function, skills, services, and fields of study. This is a provider-scraping read; billing, credit use, and account-tier behavior are unverified. |
| `HARVESTAPI_GET_COMPANY_POSTS` | Get LinkedIn Company Posts | Get one page of posts from a LinkedIn company. Date post-filtering can make provider pagination metadata inaccurate. This provider-scraping read may consume credits; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_EVENT` | Get LinkedIn Event | Get one LinkedIn event by URL or ID, including timing, venue, organizer, speakers, and announcement post. This provider-scraping read may expose personal names, profile URLs, photos, and headlines and may consume HarvestAPI credits; billing and account-tier behavior are unverified. |
| `HARVESTAPI_GET_GROUP` | Get LinkedIn Group | Get complete details for one LinkedIn group. Callers can provide a URL or group ID. Results may identify group administrators. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_JOB` | Get LinkedIn Job | Get complete details for one LinkedIn job. Callers can provide a job ID or URL. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_MY_API_USER` | Get My API User | Return details for the HarvestAPI user associated with the connected API key. Use this to identify the connected account without consuming scraping credits. The response may contain account-identifying information because the provider does not document its fields. |
| `HARVESTAPI_GET_MY_PRIVATE_ACCOUNT_POOLS` | Get My Private Account Pools | Return private LinkedIn account-pool details associated with the connected HarvestAPI API user. This platform account-metadata read does not invoke a LinkedIn scraping endpoint or consume scraping credits. The undocumented response may contain sensitive pool and backing-account identifiers. |
| `HARVESTAPI_GET_POST` | Get LinkedIn Post | Get one LinkedIn post by URL. This provider-scraping read may consume HarvestAPI credits and returns authored content and author identity; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_POST_COMMENT_REPLIES` | Get LinkedIn Post Comment Replies | Get one page of replies to a LinkedIn comment. This provider-scraping read returns repliers' identities, profile details, and authored text. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_POST_COMMENTS` | Get LinkedIn Post Comments | Get one page of comments for a LinkedIn post. This provider-scraping read returns commenters' identities, profile details, and authored text. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_POST_REACTIONS` | Get LinkedIn Post Reactions | Get one page of reactions to a LinkedIn post. This provider-scraping read returns reactors' profile identity and position; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_PROFILE` | Get LinkedIn Profile | Enrich one LinkedIn profile by URL, public identifier, or profile ID. Profile enrichment consumes HarvestAPI credits; main=true uses fewer credits. find_email=true explicitly opts into separately billable email discovery and SMTP validation and may return professional or publicly disclosed personal email addresses, including risky catch-all results. |
| `HARVESTAPI_GET_PROFILE_BY_EMAIL` | Get LinkedIn Profile by Email | Reverse lookup a LinkedIn profile from a work email address. This provider-scraping read exposes personal identity, employment, profile, and supplied email data. It consumes HarvestAPI credits; exact billing and account-tier behavior are unverified. Personal email domains and role addresses may be rejected. |
| `HARVESTAPI_GET_PROFILE_COMMENTS` | Get LinkedIn Profile Comments | Get one page of comments authored by a LinkedIn profile, optionally limited by age. This provider-scraping read exposes a person's authored activity, identity, and profile details. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_GET_PROFILE_POSTS` | Get LinkedIn Profile Posts | Use this dedicated profile feed to retrieve a profile's complete authored-post history one page at a time; unlike SEARCH_POSTS, it is intended for complete profile post retrieval. Date post-filtering can make provider pagination metadata inaccurate. This provider-scraping read may consume credits and returns a person's authored content and identity; billing and account-tier behavior are not verified. |
| `HARVESTAPI_GET_PROFILE_REACTIONS` | Get LinkedIn Profile Reactions | Get one page of reactions made by a LinkedIn profile. This provider-scraping read exposes a person's reaction activity and profile identity; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_ACCOUNTS` | Search LinkedIn Accounts | Find LinkedIn companies with advanced recruiting and sales filters such as growth, hiring, department headcount, activity, and exclusions, returning one 25-result page. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_ADS` | Search LinkedIn Ads | Search the LinkedIn Ad Library by a complete search URL or structured keyword, advertiser, country, and date filters, returning one page. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_COMPANIES` | Search LinkedIn Companies | Find LinkedIn companies by name keywords, location, size, or industry and return one controllable result page. This is a provider-scraping read; billing and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_EVENTS` | Search LinkedIn Events | Search LinkedIn events by keywords and return one controllable page. Results may expose organizer names and public event details and this provider-scraping read may consume HarvestAPI credits; billing and account-tier behavior are unverified. |
| `HARVESTAPI_SEARCH_GEO_IDS` | Search LinkedIn Geo IDs | Resolve location text to LinkedIn Geo IDs for precise people and company search filters. This is a provider-scraping read; billing and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_GROUPS` | Search LinkedIn Groups | Search LinkedIn groups by keyword and return one controllable result page. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_JOBS` | Search LinkedIn Jobs | Search LinkedIn jobs by title, company, location, work arrangement, employment type, salary, recency, seniority, industry, or function and return one controllable page. This is a provider-scraping read; billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_LEADS` | Search LinkedIn Leads | Search LinkedIn people for recruiting candidates or sales prospects with advanced inclusion and exclusion filters, including a Sales Navigator search URL, and return one controllable result page. This provider-scraping operation returns personal identity, employment, and location data. Billing, credit use, and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_POSTS` | Search LinkedIn Posts | Search LinkedIn posts by keywords, authors, companies, mentions, content type, group, and date controls, returning one page only. Provider date post-filtering can make pagination metadata and has_more inaccurate. Profile and company author filters may return fewer results; use GET_PROFILE_POSTS or GET_COMPANY_POSTS for complete author feeds. This provider-scraping read may consume credits and returns authored content and identities; billing and account-tier behavior are not verified. |
| `HARVESTAPI_SEARCH_PROFILES` | Search LinkedIn Profiles | Search public LinkedIn profiles by person, employer, school, title, location, industry, or follower relationship and return one result page. Results can be anonymized. This provider-scraping read returns personal identity, employment, location, and profile URL data; billing, credit use, and tier behavior are unverified. |
| `HARVESTAPI_SEARCH_SERVICES` | Search LinkedIn Services | Search LinkedIn service-provider profiles by service or name keywords and location. This provider-scraping read returns personal identity, position, location, and profile URL data; billing, credit use, and tier behavior are unverified. |
| `HARVESTAPI_SEARCH_TYPEAHEAD` | Search LinkedIn Typeahead | Return LinkedIn search-bar suggestions or one page of company, school, or profile suggestions. Typed searches expose up to 100 results per page and may return personal identity and profile data. This is a provider-scraping read that consumes HarvestAPI credits; exact billing and tier behavior are unverified. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

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

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

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

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to HarvestAPI
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["harvestapi"])
tools = session.tools()
```

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

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["harvestapi"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run HarvestAPI tools with your agent

Send a request, execute the HarvestAPI tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "Search LinkedIn for senior software engineers in Austin, Texas"}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Search LinkedIn for senior software engineers in Austin, Texas" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

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

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

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

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to HarvestAPI and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["harvestapi"], mcp=True)
```

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["harvestapi"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a HarvestAPI request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to HarvestAPI tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("Search LinkedIn for senior software engineers in Austin, Texas")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

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

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Search LinkedIn for senior software engineers in Austin, Texas",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native HarvestAPI Integration

- Supports both HarvestAPI MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable people and company searches
- Rich coverage for LinkedIn profile and company enrichment workflows

### 2. Managed Auth

- Secure API key handling without hard-coding credentials in your agent
- Central place to manage, scope, and revoke HarvestAPI access
- Per user and per environment credentials for safer recruiting workflows

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Clear search and enrichment inputs help agents choose the right HarvestAPI tool
- Comprehensive execution logs show what ran, when, and on whose behalf

### 4. Enterprise Grade Security

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

## Use HarvestAPI with any AI Agent Framework

Choose a framework you want to connect HarvestAPI with:

- [ChatGPT](https://composio.dev/toolkits/harvestapi/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/harvestapi/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/harvestapi/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/harvestapi/framework/atomic-agent)

## Related Toolkits

- [Ashby](https://composio.dev/toolkits/ashby) - Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics.
- [7shifts](https://composio.dev/toolkits/7shifts) - 7shifts is a restaurant team management platform for scheduling, time clocks, payroll, and team communication. It helps operators keep labor, shifts, and staff workflows organized in one place.
- [AI Ark](https://composio.dev/toolkits/ai_ark) - AI Ark is a people and company intelligence platform with search, enrichment, and recruiting APIs. It helps teams find accurate contact data and discover hiring insights faster.
- [Alion](https://composio.dev/toolkits/alion) - Alion is a REST API for company, job, people, investor, market, and hiring intelligence. It helps teams enrich research with structured business and workforce data.
- [Async interview](https://composio.dev/toolkits/async_interview) - Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime.
- [Bamboohr](https://composio.dev/toolkits/bamboohr) - BambooHR is a cloud-based HR management platform for small and mid-sized businesses. It streamlines employee data, HR workflows, and reporting in one easy interface.
- [Breathe HR](https://composio.dev/toolkits/breathehr) - Breathe HR is cloud-based HR software for SMEs to manage employee data, absences, and performance. It simplifies HR admin, making it easy to keep employee records accurate and up to date.
- [Breezy Hr](https://composio.dev/toolkits/breezy_hr) - Breezy HR is a recruiting and applicant tracking platform for managing jobs, candidates, pipelines, and hiring teams. It helps teams move faster from job posting to offer without losing track of applicants.
- [Connecteam](https://composio.dev/toolkits/connecteam) - Connecteam is a workforce management platform for deskless teams, streamlining operations, HR, and team communication. It helps businesses save time by automating scheduling, time tracking, and staff engagement tasks.
- [ContactOut](https://composio.dev/toolkits/contactout) - ContactOut is a professional profile enrichment and contact discovery API. Find and verify email addresses to power recruiting, sales, and outreach.
- [Coresignal](https://composio.dev/toolkits/coresignal) - Coresignal is a real-time public web data platform for employee, company, and professional profile intelligence. It helps teams access fresh workforce data for research, recruiting, sales, and market analysis.
- [Deel](https://composio.dev/toolkits/deel) - Deel is a global payroll and compliance platform for hiring international contractors and employees. It helps businesses pay global teams and manage local employment requirements.
- [Deputy](https://composio.dev/toolkits/deputy) - Deputy is a workforce management platform for scheduling, employees, timesheets, leave, and workplace locations. It helps teams simplify staff planning, time tracking, and daily workforce operations.
- [Dice MCP](https://composio.dev/toolkits/dice_mcp) - Dice MCP is an MCP server for searching Dice's tech-job database by role, company, location, and employment type. It helps agents find relevant tech roles fast with conversational filters.
- [Greenhouse](https://composio.dev/toolkits/greenhouse) - Greenhouse is applicant tracking and recruiting software for managing jobs, candidates, interviews, and hiring workflows. It helps recruiting teams move faster with structured pipelines, collaboration tools, and hiring data in one place.
- [Gusto](https://composio.dev/toolkits/gusto) - Gusto is a payroll, benefits, and HR platform for small and medium businesses. It helps teams run payroll, manage people, and stay compliant with less busywork.
- [HiBob](https://composio.dev/toolkits/hibob) - HiBob is a human resources platform for managing people data, time off, attendance, and workforce planning. It gives HR teams one place to organize employee information and daily people operations.
- [Hireflix](https://composio.dev/toolkits/hireflix) - Hireflix is a one-way video interview platform for hiring teams. It helps teams manage positions, candidate interviews, templates, and branded hiring workflows in one place.
- [HR Partner](https://composio.dev/toolkits/hr_partner) - HR Partner is a human resources platform for managing employee records, leave, recruitment, performance, timesheets, and expenses. Use it to centralize HR workflows, automate manual HR tasks, and keep employee data organized.
- [Job Search (Rapid API)](https://composio.dev/toolkits/job_search) - Job Search (Rapid API) is a unified service that searches approved job-listing sources via RapidAPI hosts. Use it to aggregate and query listings across providers with a single API.

## Frequently Asked Questions

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

Yes, HarvestAPI requires you to configure your own API key. 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)
