> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Lemlist: Post Database Companies

> Search Companies Database. Includes SDK V2 and CLI requests, input constraints, response fields, and Deepline credit cost.

Search Companies Database.

<Info>
  Tool ID: `lemlist_post_database_companies`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'lemlist_post_database_companies',
  {
    "filters": [
      {
        "filterId": "filter_123",
        "in": [
          "example"
        ],
        "out": [
          "example"
        ]
      }
    ],
    "page": 123,
    "size": 123
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute lemlist_post_database_companies --input '{
  "filters": [
    {
      "filterId": "filter_123",
      "in": [
        "example"
      ],
      "out": [
        "example"
      ]
    }
  ],
  "page": 123,
  "size": 123
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "results": [
      {
        "company_id": "company_123",
        "company_website_url": "https://example.com/resource",
        "company_name": "Example Corp"
      }
    ],
    "total": 123,
    "took": 123
  }
}
```

Use `deepline tools get lemlist_post_database_companies --json` for the latest machine-readable contract.

## Input reference

Search the lemlist Companies database using structured filters with pagination support. Returns comprehensive company data including technologies used, location, employee count, and other business intelligence.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.filters` | `array` | No | — | Array of filter objects to narrow down search results. Each filter has a filterId and inclusion/exclusion criteria. |
| `payload.page` | `integer` | No | — | Page number for pagination (default: 1) |
| `payload.size` | `integer` | No | — | Number of results per page (default: 100, max: 500) |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Search the lemlist Companies database using structured filters with pagination support. Returns comprehensive company data including technologies used, location, employee count, and other business intelligence.",
    "properties": {
      "filters": {
        "type": "array",
        "description": "Array of filter objects to narrow down search results. Each filter has a filterId and inclusion/exclusion criteria.",
        "items": {
          "type": "object",
          "properties": {
            "filterId": {
              "type": "string",
              "description": "The identifier of the filter to apply (e.g., 'currentCompanyTechnologies', 'companySize', 'industry')"
            },
            "in": {
              "type": "array",
              "description": "Array of values to include in the filter",
              "items": {
                "type": "string"
              }
            },
            "out": {
              "type": "array",
              "description": "Array of values to exclude from the filter",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        }
      },
      "page": {
        "type": "integer",
        "description": "Page number for pagination (default: 1)"
      },
      "size": {
        "type": "integer",
        "description": "Number of results per page (default: 100, max: 500)"
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.results` | `array` | No | — | — |
| `result.data.results[].company_id` | `string` | No | — | Unique company identifier |
| `result.data.results[].company_website_url` | `string` | No | — | Official company website URL Format: `uri`. |
| `result.data.results[].company_name` | `string` | No | — | Company name |
| `result.data.results[].company_linkedin_url` | `string` | No | — | LinkedIn company profile URL Format: `uri`. |
| `result.data.results[].last_updated` | `string` | No | — | Last update timestamp (UTC) |
| `result.data.results[].company_headquarters_city` | `string` | No | — | Headquarters city |
| `result.data.results[].company_headquarters_country` | `string` | No | — | Headquarters country |
| `result.data.results[].company_logo_url` | `string` | No | — | Company logo image URL Format: `uri`. |
| `result.data.results[].company_description` | `string` | No | — | Long company description |
| `result.data.results[].company_employee_count` | `string` | No | — | Employee count as string |
| `result.data.results[].company_type` | `string` | No | — | Company type (e.g., Privately Held, Public Company) |
| `result.data.results[].company_founded` | `string` | No | — | Year founded as string |
| `result.data.results[].company_followers_count` | `string` | No | — | LinkedIn followers count as string |
| `result.data.results[].company_size` | `string` | No | — | Company size bucket |
| `result.data.results[].revenue_bucket` | `string` | No | — | Revenue range bucket |
| `result.data.results[].company_domain` | `string` | No | — | Company web domain |
| `result.data.results[].employees_count_growth` | `integer` | No | — | Employee count growth number |
| `result.data.results[].last_funding_round_at` | `string` | No | — | Date of last funding round |
| `result.data.results[].techno_used_array` | `array` | No | — | Array of technologies used by the company |
| `result.data.results[].business_business_customer` | `"B2B" \| "B2C" \| "B2B2C"` | No | — | Customer type Allowed: `B2B`, `B2C`, `B2B2C`. |
| `result.data.results[].company_quality_score` | `string` | No | — | Quality score as string |
| `result.data.results[].company_industry` | `string` | No | — | Primary industry |
| `result.data.results[].company_subindustry` | `string` | No | — | Sub-industry |
| `result.data.results[].company_subsubindustry` | `string` | No | — | Sub-sub-industry |
| `result.data.results[].company_location` | `string` | No | — | Full formatted location |
| `result.data.results[].company_location_geopoint_array` | `array` | No | — | Geopoint coordinates \[longitude, latitude] |
| `result.data.results[].company_occ_lead` | `string` | No | — | Occupational lead count as string |
| `result.data.results[]._score` | `number` | No | — | Search relevance score |
| `result.data.results[]._id` | `string` | No | — | Internal document ID |
| `result.data.total` | `integer` | No | — | Total number of companies matching the search criteria |
| `result.data.took` | `integer` | No | — | Time taken for the search in milliseconds |
| `result.data.page` | `integer` | No | — | Current page number |
| `result.data.size` | `integer` | No | — | Number of results per page |
| `result.data.search` | `string` | No | — | Search session identifier |
| `result.data.limitation` | `integer` | No | — | Result limitation applied |
| `result.data.team` | `string` | No | — | Team identifier |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A company record from lemlist's Companies database.",
              "properties": {
                "company_id": {
                  "type": "string",
                  "description": "Unique company identifier"
                },
                "company_website_url": {
                  "type": "string",
                  "description": "Official company website URL",
                  "format": "uri"
                },
                "company_name": {
                  "type": "string",
                  "description": "Company name"
                },
                "company_linkedin_url": {
                  "type": "string",
                  "description": "LinkedIn company profile URL",
                  "format": "uri"
                },
                "last_updated": {
                  "type": "string",
                  "description": "Last update timestamp (UTC)"
                },
                "company_headquarters_city": {
                  "type": "string",
                  "description": "Headquarters city"
                },
                "company_headquarters_country": {
                  "type": "string",
                  "description": "Headquarters country"
                },
                "company_logo_url": {
                  "type": "string",
                  "description": "Company logo image URL",
                  "format": "uri"
                },
                "company_description": {
                  "type": "string",
                  "description": "Long company description"
                },
                "company_employee_count": {
                  "type": "string",
                  "description": "Employee count as string"
                },
                "company_type": {
                  "type": "string",
                  "description": "Company type (e.g., Privately Held, Public Company)"
                },
                "company_founded": {
                  "type": "string",
                  "description": "Year founded as string"
                },
                "company_followers_count": {
                  "type": "string",
                  "description": "LinkedIn followers count as string"
                },
                "company_size": {
                  "type": "string",
                  "description": "Company size bucket"
                },
                "revenue_bucket": {
                  "type": "string",
                  "description": "Revenue range bucket"
                },
                "company_domain": {
                  "type": "string",
                  "description": "Company web domain"
                },
                "employees_count_growth": {
                  "type": "integer",
                  "description": "Employee count growth number"
                },
                "last_funding_round_at": {
                  "type": "string",
                  "description": "Date of last funding round"
                },
                "techno_used_array": {
                  "type": "array",
                  "description": "Array of technologies used by the company",
                  "items": {
                    "type": "string"
                  }
                },
                "business_business_customer": {
                  "type": "string",
                  "description": "Customer type",
                  "enum": [
                    "B2B",
                    "B2C",
                    "B2B2C"
                  ]
                },
                "company_quality_score": {
                  "type": "string",
                  "description": "Quality score as string"
                },
                "company_industry": {
                  "type": "string",
                  "description": "Primary industry"
                },
                "company_subindustry": {
                  "type": "string",
                  "description": "Sub-industry"
                },
                "company_subsubindustry": {
                  "type": "string",
                  "description": "Sub-sub-industry"
                },
                "company_location": {
                  "type": "string",
                  "description": "Full formatted location"
                },
                "company_location_geopoint_array": {
                  "type": "array",
                  "description": "Geopoint coordinates [longitude, latitude]",
                  "items": {
                    "type": "number"
                  }
                },
                "company_occ_lead": {
                  "type": "string",
                  "description": "Occupational lead count as string"
                },
                "_score": {
                  "type": "number",
                  "description": "Search relevance score"
                },
                "_id": {
                  "type": "string",
                  "description": "Internal document ID"
                }
              },
              "additionalProperties": true
            }
          },
          "total": {
            "type": "integer",
            "description": "Total number of companies matching the search criteria"
          },
          "took": {
            "type": "integer",
            "description": "Time taken for the search in milliseconds"
          },
          "page": {
            "type": "integer",
            "description": "Current page number"
          },
          "size": {
            "type": "integer",
            "description": "Number of results per page"
          },
          "search": {
            "type": "string",
            "description": "Search session identifier"
          },
          "limitation": {
            "type": "integer",
            "description": "Result limitation applied"
          },
          "team": {
            "type": "string",
            "description": "Team identifier"
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Lemlist provider guide](/docs/providers/lemlist/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.