Fast Entity Search

API reference

A successful asynchronous create call returns a receipt. Use the provider’s status/result operation with that receipt ID to check whether the upstream job has completed.

curl https://gw.asale.ai/v1/tool-runs \
  -H 'Authorization: Bearer <ASALE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' \
  -d '{
  "tool": "findall.entity.search",
  "input": {
    "body": {
      "entity_type": "people",
      "objective": "IANA example domains"
    }
  },
  "max_cost_micros": 5000
}'

curl https://gw.asale.ai/v1/tool-runs/<RUN_ID> -H 'Authorization: Bearer <ASALE_API_KEY>'

{
  "$defs": {
    "FindAllEntitySearchRequest": {
      "properties": {
        "entity_type": {
          "description": "Type of entity to search for.",
          "enum": [
            "people",
            "companies"
          ],
          "title": "Entity Type",
          "type": "string"
        },
        "match_limit": {
          "default": 100,
          "description": "Maximum number of entities to return. Must be between 5 and 1000 (inclusive). May return fewer results. Defaults to 100.",
          "maximum": 1000,
          "minimum": 5,
          "title": "Match Limit",
          "type": "integer"
        },
        "objective": {
          "description": "Natural language description of target entities.",
          "title": "Objective",
          "type": "string"
        }
      },
      "required": [
        "entity_type",
        "objective"
      ],
      "title": "FindAllEntitySearchRequest",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "body": {
      "$ref": "#/$defs/FindAllEntitySearchRequest"
    }
  },
  "required": [
    "body"
  ],
  "type": "object"
}

Price

0.005000 USDT / request

Starting price shown. Get a quote for your current inputs; settlement uses actual consumption and refunds the difference.

Tests use your account balance and the selected key’s budget. The cost limit caps this API call; it does not include future calls or recurring upstream jobs.

Price revision 5

Search

Asale matches available channels by price. The reference is the highest verified channel reference price. Only definite rejections may transfer to another channel; uncertain executions require reconciliation to avoid duplicate charges.

Supply channels: 1