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

# Get Entities

> Get businesses and/or products with deployed AI sites

Internal endpoint for the Cron service to get entities (businesses and products) for batch processing.

## Query Parameters

<ParamField query="business_id" type="string">
  Filter by specific business slug. If omitted, returns all businesses.
</ParamField>

<ParamField query="type" type="string">
  Filter by entity type: - `"business"` - Only businesses (no product\_id) -
  `"product"` - Only products (has product\_id) - Omit for all entities
</ParamField>

## Response

<ResponseField name="entities" type="array">
  Array of entity objects with `business_id`, `product_id` (null for businesses),
  `source_url`, `deployment_url`
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://searchcompany-main.up.railway.app/api/cron/entities?business_id=nike&type=business"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "entities": [
      {
        "business_id": "nike",
        "product_id": null,
        "source_url": "https://nike.com",
        "deployment_url": "https://nike-com.searchcompany.dev"
      },
      {
        "business_id": "nike",
        "product_id": "air-max-90",
        "source_url": "https://nike.com/air-max-90",
        "deployment_url": "https://nike-com-air-max-90.searchcompany.dev"
      }
    ]
  }
  ```
</ResponseExample>

## Example Queries

| Use Case                     | URL                                                |
| ---------------------------- | -------------------------------------------------- |
| All entities                 | `/api/cron/entities`                               |
| Single business              | `/api/cron/entities?business_id=nike`              |
| All businesses (no products) | `/api/cron/entities?type=business`                 |
| All products only            | `/api/cron/entities?type=product`                  |
| Products for one business    | `/api/cron/entities?business_id=nike&type=product` |