Asalebeta
Tool market
Search

Apple App Listings Search Live

AppleAppListingsSearchLive

Run a test
Price
0.101000 USDT / request
Status
Available
Official reference
0.101000 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": "app.data.apple.app.listings.search.live",
  "input": {
    "body": [
      {
        "limit": 1
      }
    ]
  },
  "max_cost_micros": 101000
}'
curl https://gw.asale.ai/v1/tool-runs/<RUN_ID> -H 'Authorization: Bearer <ASALE_API_KEY>'
ParameterRequiredType
bodyNoarray
Full input schema
{
  "$defs": {
    "AppDataAppleAppListingsSearchLiveRequestInfo": {
      "properties": {
        "categories": {
          "anyOf": [
            {
              "description": "app categoriesoptional fieldthe categories you specify are used to search for app listings;you can get the full list of available app listing categories by this linkyou can specify up to 10 categories",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "description": "keyword in the app's descriptionoptional fieldkeywords that occur in the description of the app;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_likeyou can use the % operator with like and not_like to match any string of zero or more charactersexample:[\"rating.value\",\">\",3]you can receive the list of available filters_by making a separate request to https",
              "items": {
                "anyOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "limit": {
          "anyOf": [
            {
              "description": "the maximum number of returned appsoptional fielddefault value: 100maximum value: 1000",
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "offset": {
          "anyOf": [
            {
              "description": "offset in the results array of returned appsoptional 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 task Note: 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:[\"item.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:[\"item.rating.value,desc\",\"item.rating.valu",
              "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": "keyword in the app's titleoptional fieldkeywords that occur in the title of the app;can contain up to 200 characters",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "body": {
      "items": {
        "anyOf": [
          {
            "oneOf": [
              {
                "$ref": "#/$defs/AppDataAppleAppListingsSearchLiveRequestInfo"
              }
            ],
            "type": "object"
          },
          {
            "type": "null"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}

Price

0.101000 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