> ## 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.

# Ai Ark Company Search: Inputs, Cost & CLI Example

> Search companies by documented account filters including domain, name, industry, location, funding, technology, headcount, revenue, and lookalikes.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=ai_ark_company_search:{}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                       | Type      | Required | Default | Description                                                                 |
| -------------------------- | --------- | -------- | ------- | --------------------------------------------------------------------------- |
| `payload.page`             | `integer` | No       | `0`     |                                                                             |
| `payload.size`             | `integer` | No       | `10`    |                                                                             |
| `payload.lookalikeDomains` | `array`   | No       |         |                                                                             |
| `payload.name`             | `string`  | No       |         | Deepline alias for account.name.any.include when searching by company name. |
| `payload.account`          | `object`  | No       |         |                                                                             |
| `payload.lists`            | `object`  | No       |         |                                                                             |

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

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "page": {
        "type": "integer",
        "default": 0,
        "minimum": 0
      },
      "size": {
        "type": "integer",
        "default": 10,
        "minimum": 1,
        "maximum": 100
      },
      "lookalikeDomains": {
        "type": "array",
        "maxItems": 5,
        "items": {
          "type": "string"
        }
      },
      "name": {
        "type": "string",
        "description": "Deepline alias for account.name.any.include when searching by company name."
      },
      "account": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "linkedin": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "url": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "name": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "socialMediaLink": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "phoneNumber": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "industries": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "location": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "productAndServices": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "socialMedia": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "FACEBOOK",
                        "INSTAGRAM",
                        "TWITTER",
                        "LINKEDIN"
                      ]
                    }
                  },
                  "exclude": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "FACEBOOK",
                        "INSTAGRAM",
                        "TWITTER",
                        "LINKEDIN"
                      ]
                    }
                  }
                },
                "additionalProperties": false
              },
              "all": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "FACEBOOK",
                        "INSTAGRAM",
                        "TWITTER",
                        "LINKEDIN"
                      ]
                    }
                  },
                  "exclude": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "FACEBOOK",
                        "INSTAGRAM",
                        "TWITTER",
                        "LINKEDIN"
                      ]
                    }
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "type": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "PRIVATELY_HELD",
                        "SELF_OWNED",
                        "SELF_EMPLOYED",
                        "PARTNERSHIP",
                        "PUBLIC_COMPANY",
                        "NON_PROFIT",
                        "EDUCATIONAL",
                        "GOVERNMENT_AGENCY"
                      ]
                    }
                  },
                  "exclude": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "PRIVATELY_HELD",
                        "SELF_OWNED",
                        "SELF_EMPLOYED",
                        "PARTNERSHIP",
                        "PUBLIC_COMPANY",
                        "NON_PROFIT",
                        "EDUCATIONAL",
                        "GOVERNMENT_AGENCY"
                      ]
                    }
                  }
                },
                "additionalProperties": false
              },
              "all": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "PRIVATELY_HELD",
                        "SELF_OWNED",
                        "SELF_EMPLOYED",
                        "PARTNERSHIP",
                        "PUBLIC_COMPANY",
                        "NON_PROFIT",
                        "EDUCATIONAL",
                        "GOVERNMENT_AGENCY"
                      ]
                    }
                  },
                  "exclude": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string",
                      "enum": [
                        "PRIVATELY_HELD",
                        "SELF_OWNED",
                        "SELF_EMPLOYED",
                        "PARTNERSHIP",
                        "PUBLIC_COMPANY",
                        "NON_PROFIT",
                        "EDUCATIONAL",
                        "GOVERNMENT_AGENCY"
                      ]
                    }
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "foundedYear": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "RANGE"
                  },
                  "range": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "number"
                      },
                      "end": {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "type",
                  "range"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "ALL",
                      "NONE"
                    ]
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false
              }
            ]
          },
          "employeeSize": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "RANGE"
                  },
                  "range": {
                    "anyOf": [
                      {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "object",
                          "properties": {
                            "start": {
                              "type": "number"
                            },
                            "end": {
                              "type": [
                                "number",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "start",
                            "end"
                          ],
                          "additionalProperties": false
                        }
                      },
                      {
                        "type": "object",
                        "properties": {
                          "start": {
                            "type": "number"
                          },
                          "end": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "start",
                          "end"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "type",
                  "range"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "ALL",
                      "NONE"
                    ]
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false
              }
            ]
          },
          "retailSize": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "RANGE"
                  },
                  "range": {
                    "anyOf": [
                      {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "object",
                          "properties": {
                            "start": {
                              "type": "number"
                            },
                            "end": {
                              "type": [
                                "number",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "start",
                            "end"
                          ],
                          "additionalProperties": false
                        }
                      },
                      {
                        "type": "object",
                        "properties": {
                          "start": {
                            "type": "number"
                          },
                          "end": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "start",
                          "end"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "type",
                  "range"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "ALL",
                      "NONE"
                    ]
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false
              }
            ]
          },
          "revenue": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "const": "RANGE"
                  },
                  "range": {
                    "anyOf": [
                      {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "object",
                          "properties": {
                            "start": {
                              "type": "number"
                            },
                            "end": {
                              "type": [
                                "number",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "start",
                            "end"
                          ],
                          "additionalProperties": false
                        }
                      },
                      {
                        "type": "object",
                        "properties": {
                          "start": {
                            "type": "number"
                          },
                          "end": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "start",
                          "end"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                },
                "required": [
                  "type",
                  "range"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "ALL",
                      "NONE"
                    ]
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false
              }
            ]
          },
          "language": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string"
                    }
                  },
                  "exclude": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "additionalProperties": false
              },
              "all": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string"
                    }
                  },
                  "exclude": {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "additionalProperties": false
              },
              "range": {
                "type": "object",
                "properties": {
                  "start": {
                    "type": "number"
                  },
                  "end": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "start",
                  "end"
                ],
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "geoLocation": {
            "type": "object",
            "properties": {
              "position": {
                "type": "object",
                "properties": {
                  "lat": {
                    "type": "number"
                  },
                  "lng": {
                    "type": "number"
                  }
                },
                "required": [
                  "lat",
                  "lng"
                ],
                "additionalProperties": false
              },
              "radius": {
                "type": "number"
              },
              "unit": {
                "type": "string",
                "enum": [
                  "km",
                  "mi"
                ]
              }
            },
            "required": [
              "position",
              "radius",
              "unit"
            ],
            "additionalProperties": false
          },
          "keyword": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "object",
                    "properties": {
                      "sources": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "enum": [
                                "WORD",
                                "SMART",
                                "STRICT"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "NAME",
                                "KEYWORD",
                                "SEO",
                                "DESCRIPTION",
                                "INDUSTRY"
                              ]
                            }
                          },
                          "required": [
                            "mode",
                            "source"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "content": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "content"
                    ],
                    "additionalProperties": false
                  },
                  "exclude": {
                    "type": "object",
                    "properties": {
                      "sources": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "enum": [
                                "WORD",
                                "SMART",
                                "STRICT"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "NAME",
                                "KEYWORD",
                                "SEO",
                                "DESCRIPTION",
                                "INDUSTRY"
                              ]
                            }
                          },
                          "required": [
                            "mode",
                            "source"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "content": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "content"
                    ],
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              "all": {
                "type": "object",
                "properties": {
                  "include": {
                    "type": "object",
                    "properties": {
                      "sources": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "enum": [
                                "WORD",
                                "SMART",
                                "STRICT"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "NAME",
                                "KEYWORD",
                                "SEO",
                                "DESCRIPTION",
                                "INDUSTRY"
                              ]
                            }
                          },
                          "required": [
                            "mode",
                            "source"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "content": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "content"
                    ],
                    "additionalProperties": false
                  },
                  "exclude": {
                    "type": "object",
                    "properties": {
                      "sources": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "enum": [
                                "WORD",
                                "SMART",
                                "STRICT"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "NAME",
                                "KEYWORD",
                                "SEO",
                                "DESCRIPTION",
                                "INDUSTRY"
                              ]
                            }
                          },
                          "required": [
                            "mode",
                            "source"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "content": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "content"
                    ],
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "funding": {
            "type": "object",
            "properties": {
              "type": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "string"
                }
              },
              "totalAmount": {
                "type": "object",
                "properties": {
                  "start": {
                    "type": "number"
                  },
                  "end": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "start",
                  "end"
                ],
                "additionalProperties": false
              },
              "lastAmount": {
                "type": "object",
                "properties": {
                  "start": {
                    "type": "number"
                  },
                  "end": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "start",
                  "end"
                ],
                "additionalProperties": false
              },
              "duration": {
                "type": "object",
                "properties": {
                  "start": {
                    "type": "number"
                  },
                  "end": {
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "start",
                  "end"
                ],
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "metric": {
            "type": "object",
            "properties": {
              "employee": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "object",
                  "properties": {
                    "function": {
                      "type": "array",
                      "minItems": 1,
                      "items": {
                        "type": "string",
                        "enum": [
                          "program_and_project_management",
                          "education",
                          "purchasing",
                          "accounting",
                          "sales",
                          "research",
                          "operations",
                          "customer_success_and_support",
                          "legal",
                          "product_management",
                          "media_and_communication",
                          "real_estate",
                          "quality_assurance",
                          "consulting",
                          "arts_and_design",
                          "healthcare_services",
                          "entrepreneurship",
                          "engineering",
                          "community_and_social_services",
                          "marketing",
                          "information_technology",
                          "business_development",
                          "administrative",
                          "military_and_protective_services",
                          "finance",
                          "human_resources",
                          "support"
                        ]
                      }
                    },
                    "start": {
                      "type": "number"
                    },
                    "end": {
                      "type": "number"
                    },
                    "timeFrame": {
                      "type": "string",
                      "enum": [
                        "ONE",
                        "SIX",
                        "THREE",
                        "TWELVE",
                        "TWENTY_FOUR"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              },
              "growth": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "object",
                  "properties": {
                    "function": {
                      "type": "array",
                      "minItems": 1,
                      "items": {
                        "type": "string",
                        "enum": [
                          "program_and_project_management",
                          "education",
                          "purchasing",
                          "accounting",
                          "sales",
                          "research",
                          "operations",
                          "customer_success_and_support",
                          "legal",
                          "product_management",
                          "media_and_communication",
                          "real_estate",
                          "quality_assurance",
                          "consulting",
                          "arts_and_design",
                          "healthcare_services",
                          "entrepreneurship",
                          "engineering",
                          "community_and_social_services",
                          "marketing",
                          "information_technology",
                          "business_development",
                          "administrative",
                          "military_and_protective_services",
                          "finance",
                          "human_resources",
                          "support"
                        ]
                      }
                    },
                    "start": {
                      "type": "number"
                    },
                    "end": {
                      "type": "number"
                    },
                    "timeFrame": {
                      "type": "string",
                      "enum": [
                        "ONE",
                        "SIX",
                        "THREE",
                        "TWELVE",
                        "TWENTY_FOUR"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          },
          "technology": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "technologies": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          },
          "naics": {
            "type": "object",
            "properties": {
              "any": {
                "type": "object"
              },
              "all": {
                "type": "object"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "lists": {
        "type": "object",
        "properties": {
          "company_id": {
            "type": "object",
            "properties": {
              "exclude": {
                "type": "array",
                "minItems": 1,
                "maxItems": 10,
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `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."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute ai_ark_company_search --payload '{}' --json
```

### CLI flags

| Flag                        | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `--json`                    | Print machine-readable output.                      |
| `--wait`                    | Wait for terminal provider status when supported.   |
| `--debug`                   | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS`    | Max seconds to wait in wait mode.                   |
| `--poll-interval SECONDS`   | Polling interval in seconds during wait mode.       |
| `--timeout SECONDS`         | Request timeout in seconds.                         |
| `--connect-timeout SECONDS` | Connection timeout in seconds.                      |

## Cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.02` per pricing unit.
* Billing mode: `post_deduct`.
