> For the complete documentation index, see [llms.txt](https://agpt.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agpt.co/docs/integrations/block-integrations/search.md). # DataForB2B Search Blocks for searching companies and people by structured filters using DataForB2B's B2B database — build target-account and prospect lists for sales, recruiting, and account-based marketing. ## Company Search ### What it is Search companies and accounts by structured filters — industry, headcount/size, location, funding, keywords — using DataForB2B's database. Build target-account lists for B2B sales and account-based marketing. Accepts LinkedIn URLs as identifiers. ### How it works Up to five filter slots (`filter_1_column`/`filter_1_operator`/`filter_1_value` through `filter_5_*`) are validated and combined with `and`/`or` per `match`, or you can pass a raw `filters_json` (optionally the `applied_filters` output from Smart Search) which is merged with the slot filters via AND. Filter values are matched against stored taxonomy values, so resolve them with Search Filter Typeahead rather than guessing: `industry` is `software development`, not `software`. Numeric, boolean, and text columns reject incompatible operators (`=` is accepted on every column, which is why it is the default); `between` requires exactly two comma-separated values. Results are paginated with `count` (clamped to 1-100) and non-negative `offset`. Client and server errors are surfaced via `error`, while a valid search with no matches returns an empty `results` list. ### Inputs | Input | Description | Type | Required | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | filters\_json | Escape hatch for filter shapes the slots cannot express, such as nested and/or groups. Paste 'applied\_filters' from Smart Search here with an 'offset' to paginate its results. Used alone, or merged (AND) with the filter slots above. | Dict\[str, Any] | No | | match | Combine slot conditions with 'and' or 'or' | str | No | | count | Number of results to return (1-100) | int | No | | offset | Pagination offset — 0 for page 1, then 25, 50, … to page through results | int | No | | enrich\_live | Fetch fresh live data (uses more credits) | bool | No | | filter\_1\_column | Filter 1 column | "name" \| "tagline" \| "description" \| "domain" \| "universal\_name" \| "keyword" \| "industry" \| "employee\_count" \| "country\_iso\_code" \| "city" \| "region" \| "office\_country" \| "office\_city" \| "office\_region" \| "employee\_growth\_1m" \| "employee\_growth\_6m" \| "employee\_growth\_12m" \| "recent\_hires\_count" \| "founded\_year" \| "company\_type" \| "follower\_count" \| "page\_verified" \| "category" \| "last\_funding\_amount\_usd" \| "last\_funding\_date" \| "funding\_stage\_normalized" \| "has\_funding" | No | | filter\_1\_operator | Filter 1 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_1\_value | Filter 1 value. Search matches stored values exactly, so resolve it with Search Filter Typeahead rather than guessing | str | No | | filter\_2\_column | Filter 2 column | "name" \| "tagline" \| "description" \| "domain" \| "universal\_name" \| "keyword" \| "industry" \| "employee\_count" \| "country\_iso\_code" \| "city" \| "region" \| "office\_country" \| "office\_city" \| "office\_region" \| "employee\_growth\_1m" \| "employee\_growth\_6m" \| "employee\_growth\_12m" \| "recent\_hires\_count" \| "founded\_year" \| "company\_type" \| "follower\_count" \| "page\_verified" \| "category" \| "last\_funding\_amount\_usd" \| "last\_funding\_date" \| "funding\_stage\_normalized" \| "has\_funding" | No | | filter\_2\_operator | Filter 2 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_2\_value | Filter 2 value | str | No | | filter\_3\_column | Filter 3 column | "name" \| "tagline" \| "description" \| "domain" \| "universal\_name" \| "keyword" \| "industry" \| "employee\_count" \| "country\_iso\_code" \| "city" \| "region" \| "office\_country" \| "office\_city" \| "office\_region" \| "employee\_growth\_1m" \| "employee\_growth\_6m" \| "employee\_growth\_12m" \| "recent\_hires\_count" \| "founded\_year" \| "company\_type" \| "follower\_count" \| "page\_verified" \| "category" \| "last\_funding\_amount\_usd" \| "last\_funding\_date" \| "funding\_stage\_normalized" \| "has\_funding" | No | | filter\_3\_operator | Filter 3 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_3\_value | Filter 3 value | str | No | | filter\_4\_column | Filter 4 column | "name" \| "tagline" \| "description" \| "domain" \| "universal\_name" \| "keyword" \| "industry" \| "employee\_count" \| "country\_iso\_code" \| "city" \| "region" \| "office\_country" \| "office\_city" \| "office\_region" \| "employee\_growth\_1m" \| "employee\_growth\_6m" \| "employee\_growth\_12m" \| "recent\_hires\_count" \| "founded\_year" \| "company\_type" \| "follower\_count" \| "page\_verified" \| "category" \| "last\_funding\_amount\_usd" \| "last\_funding\_date" \| "funding\_stage\_normalized" \| "has\_funding" | No | | filter\_4\_operator | Filter 4 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_4\_value | Filter 4 value | str | No | | filter\_5\_column | Filter 5 column | "name" \| "tagline" \| "description" \| "domain" \| "universal\_name" \| "keyword" \| "industry" \| "employee\_count" \| "country\_iso\_code" \| "city" \| "region" \| "office\_country" \| "office\_city" \| "office\_region" \| "employee\_growth\_1m" \| "employee\_growth\_6m" \| "employee\_growth\_12m" \| "recent\_hires\_count" \| "founded\_year" \| "company\_type" \| "follower\_count" \| "page\_verified" \| "category" \| "last\_funding\_amount\_usd" \| "last\_funding\_date" \| "funding\_stage\_normalized" \| "has\_funding" | No | | filter\_5\_operator | Filter 5 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_5\_value | Filter 5 value | str | No | ### Outputs | Output | Description | Type | | ------- | -------------------------------------------- | --------------- | | error | Error message if the operation failed | str | | result | Full search response (total, count, results) | Dict\[str, Any] | | results | List of matching companies | List\[Any] | | total | Total number of matches | int | ### Possible use case **Target Account Lists**: Build a list of companies matching industry, size, and location criteria for account-based marketing. **Market Sizing**: Estimate the number of companies matching a given ICP before launching an outbound campaign. **Funding Research**: Find companies at a particular funding stage or backed by a target investor. *** ## People Search ### What it is Search people and B2B leads by structured filters — job title, company, location, industry, seniority, skills — using DataForB2B's database. Find employees at a company, people by job title, who works where, decision-makers and key contacts (owners, founders, C-suite, VPs, directors), and build a prospect or lead list. Accepts LinkedIn URLs as identifiers. The lead-sourcing step of a prospecting or outreach workflow. ### How it works Up to five filter slots (`filter_1_column`/`filter_1_operator`/`filter_1_value` through `filter_5_*`) are validated and combined with `and`/`or` per `match`, or you can pass a raw `filters_json` (optionally the `applied_filters` output from Smart Search) which is merged with the slot filters via AND. Filter values are matched against stored taxonomy values, so resolve them with Search Filter Typeahead rather than guessing: `industry` is `software development`, not `software`. Numeric, boolean, and text columns reject incompatible operators (`=` is accepted on every column, which is why it is the default); `between` requires exactly two comma-separated values. Results are paginated with `count` (clamped to 1-100) and non-negative `offset`. Client and server errors are surfaced via `error`, while a valid search with no matches returns an empty `results` list. ### Inputs | Input | Description | Type | Required | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | | filters\_json | Escape hatch for filter shapes the slots cannot express, such as nested and/or groups. Paste 'applied\_filters' from Smart Search here with an 'offset' to paginate its results. Used alone, or merged (AND) with the filter slots above. | Dict\[str, Any] | No | | match | Combine slot conditions with 'and' or 'or' | str | No | | count | Number of results to return (1-100) | int | No | | offset | Pagination offset — 0 for page 1, then 25, 50, … to page through results | int | No | | enrich\_live | Fetch fresh live data (uses more credits) | bool | No | | filter\_1\_column | Filter 1 column | "first\_name" \| "last\_name" \| "profile\_location" \| "profile\_country" \| "profile\_industry" \| "follower\_count" \| "keyword" \| "current\_company" \| "current\_title" \| "current\_job\_location" \| "current\_company\_industry" \| "current\_company\_category" \| "current\_company\_size" \| "current\_company\_id" \| "current\_employment\_type" \| "years\_in\_current\_position" \| "years\_at\_current\_company" \| "current\_company\_has\_funding" \| "current\_company\_funding\_stage" \| "current\_company\_investor" \| "past\_company" \| "past\_title" \| "past\_job\_location" \| "past\_company\_industry" \| "past\_company\_size" \| "past\_company\_id" \| "past\_employment\_type" \| "years\_at\_past\_company" \| "skill" \| "school" \| "degree" \| "degree\_level" \| "field\_of\_study" \| "language" \| "language\_iso" \| "language\_proficiency" \| "certification" \| "certification\_authority" \| "years\_of\_experience" \| "num\_total\_jobs" \| "is\_currently\_employed" | No | | filter\_1\_operator | Filter 1 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_1\_value | Filter 1 value. Search matches stored values exactly, so resolve it with Search Filter Typeahead rather than guessing | str | No | | filter\_2\_column | Filter 2 column | "first\_name" \| "last\_name" \| "profile\_location" \| "profile\_country" \| "profile\_industry" \| "follower\_count" \| "keyword" \| "current\_company" \| "current\_title" \| "current\_job\_location" \| "current\_company\_industry" \| "current\_company\_category" \| "current\_company\_size" \| "current\_company\_id" \| "current\_employment\_type" \| "years\_in\_current\_position" \| "years\_at\_current\_company" \| "current\_company\_has\_funding" \| "current\_company\_funding\_stage" \| "current\_company\_investor" \| "past\_company" \| "past\_title" \| "past\_job\_location" \| "past\_company\_industry" \| "past\_company\_size" \| "past\_company\_id" \| "past\_employment\_type" \| "years\_at\_past\_company" \| "skill" \| "school" \| "degree" \| "degree\_level" \| "field\_of\_study" \| "language" \| "language\_iso" \| "language\_proficiency" \| "certification" \| "certification\_authority" \| "years\_of\_experience" \| "num\_total\_jobs" \| "is\_currently\_employed" | No | | filter\_2\_operator | Filter 2 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_2\_value | Filter 2 value | str | No | | filter\_3\_column | Filter 3 column | "first\_name" \| "last\_name" \| "profile\_location" \| "profile\_country" \| "profile\_industry" \| "follower\_count" \| "keyword" \| "current\_company" \| "current\_title" \| "current\_job\_location" \| "current\_company\_industry" \| "current\_company\_category" \| "current\_company\_size" \| "current\_company\_id" \| "current\_employment\_type" \| "years\_in\_current\_position" \| "years\_at\_current\_company" \| "current\_company\_has\_funding" \| "current\_company\_funding\_stage" \| "current\_company\_investor" \| "past\_company" \| "past\_title" \| "past\_job\_location" \| "past\_company\_industry" \| "past\_company\_size" \| "past\_company\_id" \| "past\_employment\_type" \| "years\_at\_past\_company" \| "skill" \| "school" \| "degree" \| "degree\_level" \| "field\_of\_study" \| "language" \| "language\_iso" \| "language\_proficiency" \| "certification" \| "certification\_authority" \| "years\_of\_experience" \| "num\_total\_jobs" \| "is\_currently\_employed" | No | | filter\_3\_operator | Filter 3 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_3\_value | Filter 3 value | str | No | | filter\_4\_column | Filter 4 column | "first\_name" \| "last\_name" \| "profile\_location" \| "profile\_country" \| "profile\_industry" \| "follower\_count" \| "keyword" \| "current\_company" \| "current\_title" \| "current\_job\_location" \| "current\_company\_industry" \| "current\_company\_category" \| "current\_company\_size" \| "current\_company\_id" \| "current\_employment\_type" \| "years\_in\_current\_position" \| "years\_at\_current\_company" \| "current\_company\_has\_funding" \| "current\_company\_funding\_stage" \| "current\_company\_investor" \| "past\_company" \| "past\_title" \| "past\_job\_location" \| "past\_company\_industry" \| "past\_company\_size" \| "past\_company\_id" \| "past\_employment\_type" \| "years\_at\_past\_company" \| "skill" \| "school" \| "degree" \| "degree\_level" \| "field\_of\_study" \| "language" \| "language\_iso" \| "language\_proficiency" \| "certification" \| "certification\_authority" \| "years\_of\_experience" \| "num\_total\_jobs" \| "is\_currently\_employed" | No | | filter\_4\_operator | Filter 4 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_4\_value | Filter 4 value | str | No | | filter\_5\_column | Filter 5 column | "first\_name" \| "last\_name" \| "profile\_location" \| "profile\_country" \| "profile\_industry" \| "follower\_count" \| "keyword" \| "current\_company" \| "current\_title" \| "current\_job\_location" \| "current\_company\_industry" \| "current\_company\_category" \| "current\_company\_size" \| "current\_company\_id" \| "current\_employment\_type" \| "years\_in\_current\_position" \| "years\_at\_current\_company" \| "current\_company\_has\_funding" \| "current\_company\_funding\_stage" \| "current\_company\_investor" \| "past\_company" \| "past\_title" \| "past\_job\_location" \| "past\_company\_industry" \| "past\_company\_size" \| "past\_company\_id" \| "past\_employment\_type" \| "years\_at\_past\_company" \| "skill" \| "school" \| "degree" \| "degree\_level" \| "field\_of\_study" \| "language" \| "language\_iso" \| "language\_proficiency" \| "certification" \| "certification\_authority" \| "years\_of\_experience" \| "num\_total\_jobs" \| "is\_currently\_employed" | No | | filter\_5\_operator | Filter 5 operator | "=" \| "!=" \| "like" \| "not\_like" \| "in" \| "not\_in" \| ">" \| ">=" \| "<" \| "<=" \| "between" | No | | filter\_5\_value | Filter 5 value | str | No | ### Outputs | Output | Description | Type | | ------- | -------------------------------------------- | --------------- | | error | Error message if the operation failed | str | | result | Full search response (total, count, results) | Dict\[str, Any] | | results | List of matching LinkedIn people / leads | List\[Any] | | total | Total number of matches | int | ### Possible use case **Prospecting**: Find employees at target companies by job title, seniority, or skill for outbound sales. **Recruiting**: Search for candidates with a specific title, location, or company background. **Org Mapping**: Identify decision-makers and key contacts across selected target accounts. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://agpt.co/docs/integrations/block-integrations/search.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.