> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenFunnel Agent Primitives

> OpenFunnel Agent Primitives provides composable company search, research, lookup, and enrichment APIs for AI sales agents.

![OpenFunnel Agent Primitives logo](https://mintcdn.com/composio-preview/gqjBKmmJCINafaiK/images/toolkits/openfunnel_agent_primitives.svg?fit=max\&auto=format\&n=gqjBKmmJCINafaiK\&q=85\&s=5bbac284d60457332784c96e97ac145a)

* **Category:** ai sales tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES`
* **Version:** 20261030\_00

## Tools

> [accordion] Cancel Bulk Lookalike Search
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_CANCEL_BULK_LOOKALIKE_SEARCH`
>
> Irreversibly request cancellation of a pending or running bulk lookalike job. The response only acknowledges the asynchronous request; use GET\_BULK\_LOOKALIKE\_RESULTS afterward to observe terminal cancelled status and retrieve partial results. Companies delivered before cancellation remain available and billable.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> Pending or running bulk lookalike job ID to irreversibly request cancellation for.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Bulk Lookalike Results
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_GET_BULK_LOOKALIKE_RESULTS`
>
> Check an asynchronous bulk lookalike job and return one result page. Use status to determine completion: pending, running, and cancelling jobs remain pollable even when next\_cursor is null.
>
> #### Input Parameters
>
> **job\_id** `string` *required*
>
> Bulk job ID returned by START\_BULK\_LOOKALIKE\_SEARCH.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by the previous result page. Omit it to check job status or fetch the first available page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Credit Balance
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_GET_CREDIT_BALANCE`
>
> Return total, used, and remaining credits for the connected OpenFunnel account before or after paid searches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Country Codes
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_LIST_COUNTRY_CODES`
>
> List all ISO 3166-1 alpha-3 country codes accepted by tech-search country filters, ordered by company volume.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Firmographic Options
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_LIST_FIRMOGRAPHIC_OPTIONS`
>
> List the live funding stages, location codes, and employee bounds accepted by lookalike search filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Lookup Companies
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_LOOKUP_COMPANIES`
>
> Resolve a batch of 1-100 company names, domains, or LinkedIn URLs to ordered candidate records. Exact identifiers can still return multiple matches, so every candidate is preserved.
>
> #### Input Parameters
>
> **companies** `array` *required*
>
> One to 100 companies to resolve, in the order results should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Research Company
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_RESEARCH_COMPANY`
>
> Qualify one known company from recent hiring activity, current team composition, or both, with cited evidence. Each successful call is charged at the workspace-configured per-call credit price; an unresolved-domain 404 is free.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Primary corporate domain of the known company to research.
>
> **timeframe\_days** `integer`
>
> Recent activity window in days (1-365).
>
> **activity\_question** `string`
>
> Question answered from recent job-posting activity; provide this, qualifier\_question, or both.
>
> **max\_jobs\_to\_check** `integer`
>
> Maximum job postings to inspect for the activity question (1-200); larger values may increase latency.
>
> **qualifier\_question** `string`
>
> Question answered from LinkedIn current-employee and team-composition data; provide this, activity\_question, or both.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Companies by Tech Stack
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_SEARCH_COMPANIES_BY_TECH_STACK`
>
> Return one fixed page of 50 companies whose recent job postings mention a technology. A live non-enriched full page consumed 25 credits; enrichment or firmographic filters may cost more. Follow next\_cursor only when needed.
>
> #### Input Parameters
>
> **tech** `string`
>
> Technology name or phrase to find in recent job postings. Required when next\_cursor is omitted; continuations restore it from the opaque cursor.
>
> **enrich** `boolean`
>
> Whether to add firmographic data. Firmographic filters automatically enable enrichment and may increase the credit cost.
>
> **variations** `array`
>
> Alternative technology phrases OR-matched with tech. Each value is sent as a repeated variations query parameter.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by the previous call. Omit for the first fixed 50-company page.
>
> **lookback\_days** `integer`
>
> Number of days of job postings to search (1-365).
>
> **exclude\_vendor** `boolean`
>
> Whether to exclude job postings from the technology vendor itself.
>
> **hq\_country\_code** `string`
>
> ISO 3166-1 alpha-3 headquarters country code. Setting this filter automatically enables enrichment.
>
> **include\_evidence** `boolean`
>
> Whether to include a matching job-posting example. Set false for a leaner response documented as about six times faster.
>
> **max\_employee\_count** `integer`
>
> Inclusive maximum employee count. Setting this filter automatically enables enrichment.
>
> **min\_employee\_count** `integer`
>
> Inclusive minimum employee count. Setting this filter automatically enables enrichment.
>
> **exclude\_aggregators** `boolean`
>
> Whether to exclude known job boards, aggregators, and reposters.
>
> **exclude\_company\_slugs** `array`
>
> OpenFunnel LinkedIn company slugs to omit. Each slug is sent as a repeated exclude\_company\_slugs query parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Lookalike Companies
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_SEARCH_LOOKALIKE_COMPANIES`
>
> Find up to 100 companies similar to a natural-language trait or seed domains. Each returned company consumes 1 credit, and even an unexpected semantic match is billable, so choose limit deliberately.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum companies to return and bill in this one-shot search (1-100). Each returned company consumes 1 credit, so keep this near the number actually needed.
>
> **query** `string`
>
> Natural-language description of the target companies (1-200 characters). Provide this, seed\_domains, or both. Even an unusual semantic query can return billable matches.
>
> **locations** `array`
>
> Location codes to include, using lookalike options or EU. Values are sent as repeated locations query keys.
>
> **seed\_domains** `array`
>
> One to ten company domains used as lookalike seeds. Each domain is sent as a repeated seed\_domains query key.
>
> **max\_employees** `integer`
>
> Inclusive maximum employee count. Use LIST\_FIRMOGRAPHIC\_OPTIONS for the currently accepted bounds.
>
> **min\_employees** `integer`
>
> Inclusive minimum employee count. Use LIST\_FIRMOGRAPHIC\_OPTIONS for the currently accepted bounds.
>
> **funding\_stages** `array`
>
> Funding stages to include. Values are sent as repeated funding\_stages query keys; use LIST\_FIRMOGRAPHIC\_OPTIONS to inspect the live catalog.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Bulk Lookalike Search
>
> **Slug:** `OPENFUNNEL_AGENT_PRIMITIVES_START_BULK_LOOKALIKE_SEARCH`
>
> Start an asynchronous lookalike job for up to 10,000 companies. Delivered results are billed when the job completes, so choose limit deliberately and use GET\_BULK\_LOOKALIKE\_RESULTS to monitor the returned job\_id.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum companies the asynchronous job may deliver and bill (1-10000). Keep this near the number actually needed; delivered results are billed when the job completes.
>
> **query** `string`
>
> Natural-language description of target companies (1-200 characters); provide this, seed\_domains, or both.
>
> **locations** `array`
>
> Lookalike location codes to include, using ISO 3166-1 alpha-3 codes or EU. Use LIST\_FIRMOGRAPHIC\_OPTIONS for current values.
>
> **seed\_domains** `array`
>
> One to ten company domains used as lookalike seeds.
>
> **max\_employees** `integer`
>
> Inclusive maximum employee count. Use LIST\_FIRMOGRAPHIC\_OPTIONS for currently accepted bounds.
>
> **min\_employees** `integer`
>
> Inclusive minimum employee count. Use LIST\_FIRMOGRAPHIC\_OPTIONS for currently accepted bounds.
>
> **funding\_stages** `array`
>
> Funding stages to include. Use LIST\_FIRMOGRAPHIC\_OPTIONS to inspect the provider's current accepted values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
