[← Back to tools]
company.search

Search for companies: pay per use, no API key

Use People Data Labs from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Search People Data Labs' company dataset with bounded read-only SQL and return normalized company records. This matches structured filters (name, domain, industry code, size, location) against a company database; it is not suited for topical or category discovery, such as "startups in X space" or naming the well-known companies in an industry — use `exa.search`, `perplexity.ask`, or `brave.web-search` for that kind of research instead.

Price and execution

Price
$0.10
Pricing model
Fixed price per successful call
Execution class
fast

Limits

No additional limits are published for this tool.

Parameters

Fields company.search accepts as JSON input.

  • sqlstringRequired

    A read-only PDL SQL query selecting from the company dataset.

  • sizeintegerOptional

    Maximum company records returned and billed upstream.

Raw input JSON Schema
{
  "type": "object",
  "required": [
    "sql"
  ],
  "properties": {
    "sql": {
      "type": "string",
      "pattern": "^[Ss][Ee][Ll][Ee][Cc][Tt]\\b",
      "maxLength": 2000,
      "minLength": 20,
      "description": "A read-only PDL SQL query selecting from the company dataset."
    },
    "size": {
      "type": "integer",
      "default": 10,
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum company records returned and billed upstream."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful company.search call returns.

  • totalnumberRequired
  • companiesarray of objectRequired
    • namestringRequired
    • pdl_idstringRequired
    • websitestring | nullRequired
    • industrystring | nullRequired
    • locationstring | nullRequired
    • display_namestring | nullRequired
    • linkedin_urlstring | nullRequired
    • employee_countnumber | nullRequired
  • retrieved_atstring (date-time)Required
  • scroll_tokenstring | nullRequired
Raw output JSON Schema
{
  "type": "object",
  "required": [
    "companies",
    "total",
    "scroll_token",
    "retrieved_at"
  ],
  "properties": {
    "total": {
      "type": "number",
      "minimum": 0
    },
    "companies": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "pdl_id",
          "name",
          "display_name",
          "website",
          "linkedin_url",
          "industry",
          "employee_count",
          "location"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "pdl_id": {
            "type": "string"
          },
          "website": {
            "type": [
              "string",
              "null"
            ]
          },
          "industry": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "display_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "linkedin_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "employee_count": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          }
        },
        "additionalProperties": false
      },
      "maxItems": 10
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    },
    "scroll_token": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the company.search tool with this input: {"sql":"SELECT * FROM company WHERE website = 'example.com'","size":1}
Start with $1 freeSee pricing

Safety notes

Side Effect
read_only
Public Sources Only
Yes

How this compares to using People Data Labs directly

You do not need a separate People Data Labs account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]