Yahoo Organic Live Html
YahooOrganicLiveHtml
- Price
- 0.002000 USDT / request
- Status
- Available
- Official reference
- 0.002000 USDT / request
- Protocols
- REST · MCP
Run a test
Runs are submitted only when you click Run. Check the input and cost limit first.
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.
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": "serp.yahoo.organic.live.html",
"input": {
"body": [
{
"keyword": "IANA example domains"
}
]
},
"max_cost_micros": 2000
}'curl https://gw.asale.ai/v1/tool-runs/<RUN_ID> -H 'Authorization: Bearer <ASALE_API_KEY>'| Parameter | Required | Type |
|---|---|---|
| body | No | array |
Full input schema
{
"$defs": {
"SerpApiStopCrawlOnMatchInfo": {
"properties": {
"match_type": {
"anyOf": [
{
"description": "target match type required field if stop_crawl_on_match is specified; type of match for the match_value possible values: domain, with_subdomains, wildcard",
"type": "string"
},
{
"type": "null"
}
]
},
"match_value": {
"anyOf": [
{
"description": "arget domain or wildcard value required field if stop_crawl_on_match is specified; specify a target domain or wildcard value; Note: domain name must be specified without a request protocol; example: Asale.com",
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
},
"SerpYahooOrganicLiveHtmlRequestInfo": {
"properties": {
"depth": {
"anyOf": [
{
"description": "parsing depthoptional fieldnumber of results in SERPdefault value: 10max value: 200Your account will be billed per each SERP containing up to 10 results; Setting depth above 10 may result in additional charges if the search engine returns more than 10 results;The cost can be calculated on the Pricing page.",
"type": "integer"
},
{
"type": "null"
}
]
},
"device": {
"anyOf": [
{
"description": "device typeoptional fieldreturn results for a specific device typecan take the values:desktop, mobiledefault value: desktop",
"type": "string"
},
{
"type": "null"
}
]
},
"keyword": {
"description": "keywordrequired fieldyou can specify up to 700 characters in the keyword fieldall %## will be decoded (plus character '+' will be decoded to a space character)if you need to use the \"%\" character for your keyword, please specify it as \"%25\";if you need to use the “+” character for your keyword, please specify it as “%2B”learn more about rules and limitations of keyword and keywords fields in Asale APIs in this Help Center article",
"type": "string"
},
"language_code": {
"description": "search engine language coderequired field if you don't specify language_nameif you use this field, you don't need to specify language_nameyou can receive the list of available languages of the search engine with their language_code_by making a separate request to the",
"type": "string"
},
"language_name": {
"description": "full name of search engine languagerequired field if you don't specify language_codeif you use this field, you don't need to specify language_codeyou can receive the list of available languages of the search engine with their language_name by making a separate request to the",
"type": "string"
},
"location_code": {
"description": "search engine location coderequired field if you don't specify location_name_or location_coordinateif you use this field, you don't need to specify location_name or location_coordinateyou can receive the list of available locations of the search engines with their location_code by making a separate request to the",
"type": "integer"
},
"location_coordinate": {
"description": "GPS coordinates of a locationrequired field if you don't specify location_name_or location_codeif you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude,longitude,radius\" formatthe maximum number of decimal digits for \"latitude\" and \"longitude\": 7the minimum value for \"radius\": 199.9 (mm)the maximum value for \"radius\": 199999 (mm)example:53.476225,-2.243572,200n",
"type": "string"
},
"location_name": {
"description": "full name of search engine locationrequired field if you don't specify location_code or location_coordinateif you use this field, you don't need to specify location_code or location_coordinateyou can receive the list of available locations of the search engine with their location_name by making a separate request to the Kingdom",
"type": "string"
},
"max_crawl_pages": {
"anyOf": [
{
"description": "page crawl limitoptional fieldnumber of search results pages to crawldefault value: 1max value: 100Note: the max_crawl_pages and depth parameters complement each other;learn more at our help center",
"type": "integer"
},
{
"type": "null"
}
]
},
"os": {
"anyOf": [
{
"description": "device operating systemoptional fieldif you specify desktop in the device field, choose from the following values: windows, macosdefault value: windowsif you specify mobile in the device field, choose from the following values: android, iosdefault value: android",
"type": "string"
},
{
"type": "null"
}
]
},
"se_domain": {
"anyOf": [
{
"description": "search engine domainoptional fieldwe choose the relevant search engine domain automatically according to the location and language you specifyhowever, you can set a custom search engine domain in this fieldexample:au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, etc.",
"type": "string"
},
{
"type": "null"
}
]
},
"search_param": {
"anyOf": [
{
"description": "additional parameters of the search queryoptional fieldget the list of available parameters and additional details here",
"type": "string"
},
{
"type": "null"
}
]
},
"stop_crawl_on_match": {
"anyOf": [
{
"description": "array of targets to stop crawling optional field if specified, the response will contain SERP results up to and including the specified match_value; you can specify up to 10 target values in this array example: \"stop_crawl_on_match\":[{\"match_value\":\"Asale.com\",\"match_type\":\"with_subdomains\"}] learn more about this parameter on our Help Center - Your account will be billed per each SERP crawled through the",
"items": {
"anyOf": [
{
"oneOf": [
{
"$ref": "#/$defs/SerpApiStopCrawlOnMatchInfo"
}
],
"type": "object"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"description": "direct URL of the search queryoptional fieldyou can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we wouldn’t recommend using this method.example:https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8",
"type": "string"
},
{
"type": "null"
}
]
}
},
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"body": {
"items": {
"anyOf": [
{
"oneOf": [
{
"$ref": "#/$defs/SerpYahooOrganicLiveHtmlRequestInfo"
}
],
"type": "object"
},
{
"type": "null"
}
]
},
"type": "array"
}
},
"required": [],
"type": "object"
}Price
0.002000 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