Asalebeta
Tool market
Search

Business Listings Search Live

BusinessListingsSearchLive

Run a test
Price
0.012360 USDT / request
Status
Available
Official reference
0.012360 USDT / request
Protocols
REST · MCP

Run a test

Runs are submitted only when you click Run. Check the input and cost limit first.

Input parametersJSON

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

Sign in

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.

Run result

Run a test to see its status, charges and response here.

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": "business.data.business.listings.search.live",
  "input": {
    "body": [
      {
        "limit": 1
      }
    ]
  },
  "max_cost_micros": 12360
}'
curl https://gw.asale.ai/v1/tool-runs/<RUN_ID> -H 'Authorization: Bearer <ASALE_API_KEY>'
ParameterRequiredType
bodyNoarray
Full input schema
{
  "$defs": {
    "BusinessDataBusinessListingsSearchLiveRequestInfo": {
      "properties": {
        "categories": {
          "anyOf": [
            {
              "description": "business categoriesoptional fieldthe categories you specify are used to search for business listings;if you don't use this field, we will return business listings found in the specified location;you can specify up to 10 categories",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "description": "description of the element in SERPoptional fieldthe description of the business entity for which the results are collected;can contain up to 200 characters",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "filters": {
          "anyOf": [
            {
              "description": "array of results filtering parametersoptional fieldyou can add several filters at once (8 filters maximum)you should set a logical operator and, or between the conditionsthe following operators are supported:regex, not_regex, &lt;, &lt;=, &gt;, &gt;=, =, &lt;&gt;, in, not_in, like, not_like, ilike, not_ilike, match, not_matchyou can use the % operator with like and not_like to match any string of zero or more charactersexample:[\"rating.value\",\"&gt;\",3]you can receive the list of available filter",
              "items": {
                "anyOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "is_claimed": {
          "anyOf": [
            {
              "description": "indicates whether the business is verified by its owner on Google Mapsoptional field",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "limit": {
          "anyOf": [
            {
              "description": "the maximum number of returned businessesoptional fielddefault value: 100maximum value: 1000",
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "location_coordinate": {
          "anyOf": [
            {
              "description": "GPS coordinates of a locationoptional fieldlocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" formatthe maximum number of decimal digits for \"latitude\" and \"longitude\": 7the value of \"radius\" is specified in kilometres (km)the minimum value for \"radius\": 1the maximum value for \"radius\": 100000example:53.476225,-2.243572,200learn more about how to set location parameters in this API on our Help Center",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "offset": {
          "anyOf": [
            {
              "description": "offset in the results array of returned businessesoptional fielddefault value: 0if you specify the 10 value, the first ten entities in the results array will be omitted and the data will be provided for the successive entitiesNote: we recommend using this parameter only when retrieving up to 10,000 resultsfor retrieving over 10,000 results, use the offset_token instead",
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "offset_token": {
          "anyOf": [
            {
              "description": "token for subsequent requestsoptional fieldprovided in the identical filed of the response to each request;use this parameter to avoid timeouts while trying to obtain over 100,000 results in a single request;by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;offset_token values are unique for each subsequent taskNote: if the offset_token is specified in the request, all other parameters should be identical to the previous",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "order_by": {
          "anyOf": [
            {
              "description": "results sorting rulesoptional fieldyou can use the same values as in the filters array to sort the resultspossible sorting types:asc - results will be sorted in the ascending orderdesc - results will be sorted in the descending orderyou should use a comma to set up a sorting parameterexample:[\"rating.value,desc\"]note that you can set no more than three sorting rules in a single requestyou should use a comma to separate several sorting rulesexample:[\"rating.value,desc\",\"rating.votes_count,desc\"]",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "tag": {
          "anyOf": [
            {
              "description": "user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "title": {
          "anyOf": [
            {
              "description": "title of the element in SERPoptional fieldthe name of the business entity for which the results are collected;can contain up to 200 characters",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "body": {
      "items": {
        "anyOf": [
          {
            "oneOf": [
              {
                "$ref": "#/$defs/BusinessDataBusinessListingsSearchLiveRequestInfo"
              }
            ],
            "type": "object"
          },
          {
            "type": "null"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}

Price

0.012360 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