> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # OnPage API Pages > This endpoint returns a list of crawled pages with on-page check-ups and other metrics related to the page performance. Using this function you will get page-specific data with detailed information on how well your pages are optimized for search. for more info please visit 'https://docs.dataforseo.com/v3/on_page/pages/?bash' Usage-based billing; Default request estimate: $0.012 USD (not a fixed price). Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/dataforseo/on\_page/pages * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/dataforseo/on\_page/pages](https://api.aisa.one/apis/v1/dataforseo/on\_page/pages) * **Runtime facts:** 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c [Complete OpenAPI definition](https://aisa.one/docs/openapi/dataforseo.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "any_dataforseo_apis_v1_dataforseo_on_page_pages", "method": "POST", "path": "/apis/v1/dataforseo/on_page/pages", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "example": [ { "filters": [ [ "resource_type", "=", "html" ], "and", [ "meta.scripts_count", ">", 40 ] ], "id": "07281559-0695-0216-0000-c269be8b7592", "limit": 10, "order_by": [ "meta.content.plain_text_word_count,desc" ] } ], "items": { "oneOf": [ { "example": [ { "filters": [ [ "resource_type", "=", "html" ], "and", [ "meta.scripts_count", ">", 40 ] ], "id": "07281559-0695-0216-0000-c269be8b7592", "limit": 10, "order_by": [ "meta.content.plain_text_word_count,desc" ] } ], "properties": { "filters": { "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, <, <=, >, >=, =, <>, in, not_in, like, not_likeyou can use the % operator with like and not_like to match any string of zero or more charactersexample:[\"meta.external_links_count\",\"<=\",50][\"url\",\"like\",\"https://dataforseo.com/apis/dataforseo-labs-api\"][[\"checks.high_waiting_time\",\"=\",false],\"and\",[\"resource_type\",\"=\",\"html\"]][[\"page_timing.duration_time\",\"<\",100],\"and\",[[\"checks.large_page_size\",\"=\",false],\"or\",[\"checks.high_waiting_time\",\"=\",false]]]The full list of possible filters is available by this link.", "items": { "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "id": { "description": "ID of the taskrequired fieldyou can get this ID in the response of the Task POST endpointexample:\"07131248-1535-0216-1000-17384017ad04\"", "type": "string" }, "limit": { "description": "the maximum number of returned pagesoptional fielddefault value: 100maximum value: 1000", "type": [ "integer", "null" ] }, "offset": { "description": "offset in the results array of returned pagesoptional fielddefault value: 0maximum value: 2000000if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages", "type": [ "integer", "null" ] }, "order_by": { "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 typeexample:[\"meta.external_links_count,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:[\"page_timing.dom_complete,asc\",\"size,desc\"]", "items": { "type": "string" }, "type": [ "array", "null" ] }, "search_after_token": { "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 20,000 results in a single request;by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request", "type": [ "string", "null" ] }, "tag": { "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", "null" ] } }, "type": "object" } ], "type": [ "object", "null" ] }, "type": "array" } } } }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_usd", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "response_body" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Usage-based billing; Default request estimate: \$0.012 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.012 * **Cost contract:** response\_usd * **Published reference multiplier:** 1.0 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml openapi/dataforseo.json POST /apis/v1/dataforseo/on_page/pages openapi: 3.1.0 info: description: '' title: DataForSEO version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-catalogs: dataforseo: description: '' title: DataForSEO x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-configured-paths: - >- /apis/v1/dataforseo/ai_optimization/ai_keyword_data/keywords_search_volume/live - >- /apis/v1/dataforseo/ai_optimization/ai_keyword_data/locations_and_languages - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/live - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/models - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/html - >- /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id} - >- /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id} - /apis/v1/dataforseo/ai_optimization/chat_gpt/llm_scraper/task_post - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/live - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/models - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/claude/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/live - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/models - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_get/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/task_post - /apis/v1/dataforseo/ai_optimization/gemini/llm_responses/tasks_ready - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/languages - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/advanced - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/live/html - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/locations - >- /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/advanced/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_get/html/{id} - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/task_post - /apis/v1/dataforseo/ai_optimization/gemini/llm_scraper/tasks_ready - /apis/v1/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/available_filters - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/historical/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/locations_and_languages - /apis/v1/dataforseo/ai_optimization/llm_mentions/multi_target_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/search/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/search_mentions/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/target_metrics_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_delta/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/timeseries_new_lost/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_domains/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brand_categories_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_brands_lite/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_domains_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages/live - >- /apis/v1/dataforseo/ai_optimization/llm_mentions/top_mentioned_pages_lite/live - /apis/v1/dataforseo/ai_optimization/llm_mentions/top_pages/live - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/live - /apis/v1/dataforseo/ai_optimization/perplexity/llm_responses/models - /apis/v1/dataforseo/app_data/apple/app_info/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_info/task_post - /apis/v1/dataforseo/app_data/apple/app_list/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_list/task_post - /apis/v1/dataforseo/app_data/apple/app_listings/categories - /apis/v1/dataforseo/app_data/apple/app_listings/search/live - /apis/v1/dataforseo/app_data/apple/app_reviews/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_reviews/task_post - /apis/v1/dataforseo/app_data/apple/app_searches/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/apple/app_searches/task_post - /apis/v1/dataforseo/app_data/apple/categories - /apis/v1/dataforseo/app_data/apple/languages - /apis/v1/dataforseo/app_data/apple/locations - /apis/v1/dataforseo/app_data/google/app_info/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_info/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_info/task_post - /apis/v1/dataforseo/app_data/google/app_list/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_list/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_list/task_post - /apis/v1/dataforseo/app_data/google/app_listings/categories - /apis/v1/dataforseo/app_data/google/app_listings/search/live - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_reviews/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_reviews/task_post - /apis/v1/dataforseo/app_data/google/app_searches/task_get/advanced/{id} - /apis/v1/dataforseo/app_data/google/app_searches/task_get/html/{id} - /apis/v1/dataforseo/app_data/google/app_searches/task_post - /apis/v1/dataforseo/app_data/google/categories - /apis/v1/dataforseo/app_data/google/languages - /apis/v1/dataforseo/app_data/google/locations - /apis/v1/dataforseo/backlinks/anchors/live - /apis/v1/dataforseo/backlinks/backlinks/live - /apis/v1/dataforseo/backlinks/bulk_backlinks/live - /apis/v1/dataforseo/backlinks/bulk_new_lost_backlinks/live - /apis/v1/dataforseo/backlinks/bulk_new_lost_referring_domains/live - /apis/v1/dataforseo/backlinks/bulk_pages_summary/live - /apis/v1/dataforseo/backlinks/bulk_ranks/live - /apis/v1/dataforseo/backlinks/bulk_referring_domains/live - /apis/v1/dataforseo/backlinks/bulk_spam_score/live - /apis/v1/dataforseo/backlinks/competitors/live - /apis/v1/dataforseo/backlinks/domain_intersection/live - /apis/v1/dataforseo/backlinks/domain_pages/live - /apis/v1/dataforseo/backlinks/domain_pages_summary/live - /apis/v1/dataforseo/backlinks/history/live - /apis/v1/dataforseo/backlinks/index - /apis/v1/dataforseo/backlinks/page_intersection/live - /apis/v1/dataforseo/backlinks/referring_domains/live - /apis/v1/dataforseo/backlinks/referring_networks/live - /apis/v1/dataforseo/backlinks/summary/live - /apis/v1/dataforseo/backlinks/timeseries_new_lost_summary/live - /apis/v1/dataforseo/backlinks/timeseries_summary/live - /apis/v1/dataforseo/business_data/business_listings/search/live - /apis/v1/dataforseo/business_data/google/extended_reviews/task_get/{id} - /apis/v1/dataforseo/business_data/google/extended_reviews/task_post - /apis/v1/dataforseo/business_data/google/extended_reviews/tasks_ready - /apis/v1/dataforseo/business_data/google/hotel_info/live/advanced - /apis/v1/dataforseo/business_data/google/hotel_info/live/html - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/advanced/{id} - /apis/v1/dataforseo/business_data/google/hotel_info/task_get/html/{id} - /apis/v1/dataforseo/business_data/google/hotel_info/task_post - /apis/v1/dataforseo/business_data/google/hotel_info/tasks_ready - /apis/v1/dataforseo/business_data/google/hotel_searches/live - /apis/v1/dataforseo/business_data/google/hotel_searches/task_get/{id} - /apis/v1/dataforseo/business_data/google/hotel_searches/task_post - /apis/v1/dataforseo/business_data/google/hotel_searches/tasks_ready - /apis/v1/dataforseo/business_data/google/my_business_info/live - /apis/v1/dataforseo/business_data/google/my_business_info/task_get/{id} - /apis/v1/dataforseo/business_data/google/my_business_info/task_post - /apis/v1/dataforseo/business_data/google/my_business_info/tasks_ready - /apis/v1/dataforseo/business_data/google/my_business_updates/task_get/{id} - /apis/v1/dataforseo/business_data/google/my_business_updates/task_post - /apis/v1/dataforseo/business_data/google/my_business_updates/tasks_ready - /apis/v1/dataforseo/business_data/google/questions_and_answers/live - >- /apis/v1/dataforseo/business_data/google/questions_and_answers/task_get/{id} - /apis/v1/dataforseo/business_data/google/questions_and_answers/task_post - /apis/v1/dataforseo/business_data/google/questions_and_answers/tasks_ready - /apis/v1/dataforseo/business_data/google/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/google/reviews/task_post - /apis/v1/dataforseo/business_data/google/reviews/tasks_ready - /apis/v1/dataforseo/business_data/social_media/pinterest/live - /apis/v1/dataforseo/business_data/social_media/reddit/live - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/tripadvisor/reviews/task_post - /apis/v1/dataforseo/business_data/tripadvisor/reviews/tasks_ready - /apis/v1/dataforseo/business_data/tripadvisor/search/task_get/{id} - /apis/v1/dataforseo/business_data/tripadvisor/search/task_post - /apis/v1/dataforseo/business_data/tripadvisor/search/tasks_ready - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_get/{id} - /apis/v1/dataforseo/business_data/trustpilot/reviews/task_post - /apis/v1/dataforseo/business_data/trustpilot/reviews/tasks_ready - /apis/v1/dataforseo/business_data/trustpilot/search/task_get/{id} - /apis/v1/dataforseo/business_data/trustpilot/search/task_post - /apis/v1/dataforseo/business_data/trustpilot/search/tasks_ready - /apis/v1/dataforseo/content_analysis/available_filters - /apis/v1/dataforseo/content_analysis/categories - /apis/v1/dataforseo/content_analysis/category_trends/live - /apis/v1/dataforseo/content_analysis/languages - /apis/v1/dataforseo/content_analysis/locations - /apis/v1/dataforseo/content_analysis/phrase_trends/live - /apis/v1/dataforseo/content_analysis/rating_distribution/live - /apis/v1/dataforseo/content_analysis/search/live - /apis/v1/dataforseo/content_analysis/sentiment_analysis/live - /apis/v1/dataforseo/content_analysis/summary/live - /apis/v1/dataforseo/dataforseo_labs/amazon/bulk_search_volume/live - /apis/v1/dataforseo/dataforseo_labs/amazon/product_competitors/live - >- /apis/v1/dataforseo/dataforseo_labs/amazon/product_keyword_intersections/live - /apis/v1/dataforseo/dataforseo_labs/amazon/product_rank_overview/live - /apis/v1/dataforseo/dataforseo_labs/amazon/ranked_keywords/live - /apis/v1/dataforseo/dataforseo_labs/amazon/related_keywords/live - /apis/v1/dataforseo/dataforseo_labs/apple/app_competitors/live - /apis/v1/dataforseo/dataforseo_labs/apple/app_intersection/live - /apis/v1/dataforseo/dataforseo_labs/apple/bulk_app_metrics/live - /apis/v1/dataforseo/dataforseo_labs/apple/keywords_for_app/live - /apis/v1/dataforseo/dataforseo_labs/available_filters - /apis/v1/dataforseo/dataforseo_labs/google/app_competitors/live - /apis/v1/dataforseo/dataforseo_labs/google/app_intersection/live - /apis/v1/dataforseo/dataforseo_labs/google/available_history - /apis/v1/dataforseo/dataforseo_labs/google/bulk_app_metrics/live - /apis/v1/dataforseo/dataforseo_labs/google/bulk_keyword_difficulty/live - /apis/v1/dataforseo/dataforseo_labs/google/bulk_traffic_estimation/live - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_domain/live - >- /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/languages - /apis/v1/dataforseo/dataforseo_labs/google/categories_for_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/competitors_domain/live - /apis/v1/dataforseo/dataforseo_labs/google/domain_intersection/live - >- /apis/v1/dataforseo/dataforseo_labs/google/domain_metrics_by_categories/live - /apis/v1/dataforseo/dataforseo_labs/google/domain_rank_overview/live - >- /apis/v1/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_keyword_data/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_rank_overview/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_search_volume/live - /apis/v1/dataforseo/dataforseo_labs/google/historical_serps/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_ideas/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_overview/live - /apis/v1/dataforseo/dataforseo_labs/google/keyword_suggestions/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_app/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_categories/live - /apis/v1/dataforseo/dataforseo_labs/google/keywords_for_site/live - /apis/v1/dataforseo/dataforseo_labs/google/page_intersection/live - /apis/v1/dataforseo/dataforseo_labs/google/ranked_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/related_keywords/live - /apis/v1/dataforseo/dataforseo_labs/google/relevant_pages/live - /apis/v1/dataforseo/dataforseo_labs/google/search_intent/live - /apis/v1/dataforseo/dataforseo_labs/google/serp_competitors/live - /apis/v1/dataforseo/dataforseo_labs/google/subdomains/live - /apis/v1/dataforseo/dataforseo_labs/google/top_searches/live - /apis/v1/dataforseo/dataforseo_labs/status - >- /apis/v1/dataforseo/domain_analytics/technologies/aggregation_technologies/live - /apis/v1/dataforseo/domain_analytics/technologies/available_filters - /apis/v1/dataforseo/domain_analytics/technologies/domain_technologies/live - >- /apis/v1/dataforseo/domain_analytics/technologies/domains_by_html_terms/live - >- /apis/v1/dataforseo/domain_analytics/technologies/domains_by_technology/live - /apis/v1/dataforseo/domain_analytics/technologies/languages - /apis/v1/dataforseo/domain_analytics/technologies/locations - /apis/v1/dataforseo/domain_analytics/technologies/technologies - >- /apis/v1/dataforseo/domain_analytics/technologies/technologies_summary/live - /apis/v1/dataforseo/domain_analytics/technologies/technology_stats/live - /apis/v1/dataforseo/domain_analytics/whois/available_filters - /apis/v1/dataforseo/domain_analytics/whois/overview/live - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/industries - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/job_functions - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/live - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/task_post - /apis/v1/dataforseo/keywords_data/bing/audience_estimation/tasks_ready - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/live - >- /apis/v1/dataforseo/keywords_data/bing/keyword_performance/locations_and_languages - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keyword_performance/task_post - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/languages - /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/live - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/task_post - >- /apis/v1/dataforseo/keywords_data/bing/keyword_suggestions_for_url/tasks_ready - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/live - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keywords_for_keywords/task_post - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/live - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/keywords_for_site/task_post - /apis/v1/dataforseo/keywords_data/bing/languages - /apis/v1/dataforseo/keywords_data/bing/locations - /apis/v1/dataforseo/keywords_data/bing/search_volume/live - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/search_volume/task_post - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/live - >- /apis/v1/dataforseo/keywords_data/bing/search_volume_history/locations_and_languages - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_get/{id} - /apis/v1/dataforseo/keywords_data/bing/search_volume_history/task_post - /apis/v1/dataforseo/keywords_data/clickstream_data/bulk_search_volume/live - >- /apis/v1/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live - >- /apis/v1/dataforseo/keywords_data/clickstream_data/global_search_volume/live - /apis/v1/dataforseo/keywords_data/clickstream_data/locations_and_languages - /apis/v1/dataforseo/keywords_data/dataforseo_trends/demography/live - /apis/v1/dataforseo/keywords_data/dataforseo_trends/explore/live - /apis/v1/dataforseo/keywords_data/dataforseo_trends/locations - /apis/v1/dataforseo/keywords_data/dataforseo_trends/merged_data/live - >- /apis/v1/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live - /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/live - >- /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/live - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_get/{id} - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_post - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/live - >- /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_ads/keywords_for_site/task_post - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/live - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_ads/search_volume/task_post - /apis/v1/dataforseo/keywords_data/google_ads/status - /apis/v1/dataforseo/keywords_data/google_trends/categories - /apis/v1/dataforseo/keywords_data/google_trends/explore/live - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_get/{id} - /apis/v1/dataforseo/keywords_data/google_trends/explore/task_post - /apis/v1/dataforseo/merchant/amazon/asin/live/advanced - /apis/v1/dataforseo/merchant/amazon/asin/live/html - /apis/v1/dataforseo/merchant/amazon/asin/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/asin/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/asin/task_post - /apis/v1/dataforseo/merchant/amazon/asin/tasks_ready - /apis/v1/dataforseo/merchant/amazon/languages - /apis/v1/dataforseo/merchant/amazon/locations - /apis/v1/dataforseo/merchant/amazon/products/live/advanced - /apis/v1/dataforseo/merchant/amazon/products/live/html - /apis/v1/dataforseo/merchant/amazon/products/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/products/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/products/task_post - /apis/v1/dataforseo/merchant/amazon/products/tasks_ready - /apis/v1/dataforseo/merchant/amazon/sellers/live/advanced - /apis/v1/dataforseo/merchant/amazon/sellers/live/html - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/amazon/sellers/task_get/html/{id} - /apis/v1/dataforseo/merchant/amazon/sellers/task_post - /apis/v1/dataforseo/merchant/amazon/sellers/tasks_ready - /apis/v1/dataforseo/merchant/google/languages - /apis/v1/dataforseo/merchant/google/locations - /apis/v1/dataforseo/merchant/google/product_info/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/product_info/task_post - /apis/v1/dataforseo/merchant/google/product_info/tasks_ready - /apis/v1/dataforseo/merchant/google/products/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/products/task_get/html/{id} - /apis/v1/dataforseo/merchant/google/products/task_post - /apis/v1/dataforseo/merchant/google/products/tasks_ready - /apis/v1/dataforseo/merchant/google/reviews/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/reviews/task_post - /apis/v1/dataforseo/merchant/google/reviews/tasks_ready - /apis/v1/dataforseo/merchant/google/sellers/ad_url - /apis/v1/dataforseo/merchant/google/sellers/task_get/advanced/{id} - /apis/v1/dataforseo/merchant/google/sellers/task_post - /apis/v1/dataforseo/merchant/google/sellers/tasks_ready - /apis/v1/dataforseo/on_page/available_filters - /apis/v1/dataforseo/on_page/content_parsing - /apis/v1/dataforseo/on_page/content_parsing/live - /apis/v1/dataforseo/on_page/duplicate_content - /apis/v1/dataforseo/on_page/duplicate_tags - /apis/v1/dataforseo/on_page/force_stop - /apis/v1/dataforseo/on_page/instant_pages - /apis/v1/dataforseo/on_page/keyword_density - /apis/v1/dataforseo/on_page/lighthouse/audits - /apis/v1/dataforseo/on_page/lighthouse/languages - /apis/v1/dataforseo/on_page/lighthouse/live/json - /apis/v1/dataforseo/on_page/lighthouse/task_get/json/{id} - /apis/v1/dataforseo/on_page/lighthouse/task_post - /apis/v1/dataforseo/on_page/lighthouse/tasks_ready - /apis/v1/dataforseo/on_page/lighthouse/versions - /apis/v1/dataforseo/on_page/links - /apis/v1/dataforseo/on_page/microdata - /apis/v1/dataforseo/on_page/non_indexable - /apis/v1/dataforseo/on_page/page_screenshot - /apis/v1/dataforseo/on_page/pages - /apis/v1/dataforseo/on_page/pages_by_resource - /apis/v1/dataforseo/on_page/raw_html - /apis/v1/dataforseo/on_page/redirect_chains - /apis/v1/dataforseo/on_page/resources - /apis/v1/dataforseo/on_page/summary/{id} - /apis/v1/dataforseo/on_page/task_post - /apis/v1/dataforseo/on_page/tasks_ready - /apis/v1/dataforseo/on_page/uncrawlable_resources - /apis/v1/dataforseo/on_page/waterfall - /apis/v1/dataforseo/serp/ai_summary - /apis/v1/dataforseo/serp/baidu/languages - /apis/v1/dataforseo/serp/baidu/locations - /apis/v1/dataforseo/serp/baidu/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/baidu/organic/task_post - /apis/v1/dataforseo/serp/baidu/organic/tasks_ready - /apis/v1/dataforseo/serp/bing/languages - /apis/v1/dataforseo/serp/bing/locations - /apis/v1/dataforseo/serp/bing/organic/live/advanced - /apis/v1/dataforseo/serp/bing/organic/live/html - /apis/v1/dataforseo/serp/bing/organic/live/regular - /apis/v1/dataforseo/serp/bing/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/bing/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/bing/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/bing/organic/task_post - /apis/v1/dataforseo/serp/bing/organic/tasks_ready - /apis/v1/dataforseo/serp/google/ads_advertisers/live/advanced - /apis/v1/dataforseo/serp/google/ads_advertisers/locations - /apis/v1/dataforseo/serp/google/ads_advertisers/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ads_advertisers/task_post - /apis/v1/dataforseo/serp/google/ads_advertisers/tasks_ready - /apis/v1/dataforseo/serp/google/ads_search/live/advanced - /apis/v1/dataforseo/serp/google/ads_search/locations - /apis/v1/dataforseo/serp/google/ads_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ads_search/task_post - /apis/v1/dataforseo/serp/google/ads_search/tasks_ready - /apis/v1/dataforseo/serp/google/ai_mode/languages - /apis/v1/dataforseo/serp/google/ai_mode/live/advanced - /apis/v1/dataforseo/serp/google/ai_mode/live/html - /apis/v1/dataforseo/serp/google/ai_mode/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/ai_mode/task_get/html/{id} - /apis/v1/dataforseo/serp/google/ai_mode/task_post - /apis/v1/dataforseo/serp/google/ai_mode/tasks_ready - /apis/v1/dataforseo/serp/google/autocomplete/live/advanced - /apis/v1/dataforseo/serp/google/autocomplete/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/autocomplete/task_post - /apis/v1/dataforseo/serp/google/autocomplete/tasks_ready - /apis/v1/dataforseo/serp/google/dataset_info/live/advanced - /apis/v1/dataforseo/serp/google/dataset_info/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/dataset_info/task_post - /apis/v1/dataforseo/serp/google/dataset_info/tasks_ready - /apis/v1/dataforseo/serp/google/dataset_search/live/advanced - /apis/v1/dataforseo/serp/google/dataset_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/dataset_search/task_post - /apis/v1/dataforseo/serp/google/dataset_search/tasks_ready - /apis/v1/dataforseo/serp/google/events/live/advanced - /apis/v1/dataforseo/serp/google/events/locations - /apis/v1/dataforseo/serp/google/events/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/events/task_post - /apis/v1/dataforseo/serp/google/events/tasks_ready - /apis/v1/dataforseo/serp/google/finance_explore/live/advanced - /apis/v1/dataforseo/serp/google/finance_explore/live/html - /apis/v1/dataforseo/serp/google/finance_explore/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_explore/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_explore/task_post - /apis/v1/dataforseo/serp/google/finance_explore/tasks_ready - /apis/v1/dataforseo/serp/google/finance_markets/live/advanced - /apis/v1/dataforseo/serp/google/finance_markets/live/html - /apis/v1/dataforseo/serp/google/finance_markets/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_markets/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_markets/task_post - /apis/v1/dataforseo/serp/google/finance_markets/tasks_ready - /apis/v1/dataforseo/serp/google/finance_quote/live/advanced - /apis/v1/dataforseo/serp/google/finance_quote/live/html - /apis/v1/dataforseo/serp/google/finance_quote/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_quote/task_get/html/{id} - /apis/v1/dataforseo/serp/google/finance_quote/task_post - /apis/v1/dataforseo/serp/google/finance_quote/tasks_ready - /apis/v1/dataforseo/serp/google/finance_ticker_search/live/advanced - >- /apis/v1/dataforseo/serp/google/finance_ticker_search/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/finance_ticker_search/task_post - /apis/v1/dataforseo/serp/google/finance_ticker_search/tasks_ready - /apis/v1/dataforseo/serp/google/images/live/advanced - /apis/v1/dataforseo/serp/google/images/live/html - /apis/v1/dataforseo/serp/google/images/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/images/task_get/html/{id} - /apis/v1/dataforseo/serp/google/images/task_get/regular/{id} - /apis/v1/dataforseo/serp/google/images/task_post - /apis/v1/dataforseo/serp/google/images/tasks_ready - /apis/v1/dataforseo/serp/google/jobs/locations - /apis/v1/dataforseo/serp/google/jobs/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/jobs/task_get/html/{id} - /apis/v1/dataforseo/serp/google/jobs/task_post - /apis/v1/dataforseo/serp/google/jobs/tasks_ready - /apis/v1/dataforseo/serp/google/languages - /apis/v1/dataforseo/serp/google/local_finder/live/advanced - /apis/v1/dataforseo/serp/google/local_finder/live/html - /apis/v1/dataforseo/serp/google/local_finder/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/local_finder/task_get/html/{id} - /apis/v1/dataforseo/serp/google/local_finder/task_post - /apis/v1/dataforseo/serp/google/local_finder/tasks_ready - /apis/v1/dataforseo/serp/google/locations - /apis/v1/dataforseo/serp/google/maps/live/advanced - /apis/v1/dataforseo/serp/google/maps/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/maps/task_post - /apis/v1/dataforseo/serp/google/maps/tasks_ready - /apis/v1/dataforseo/serp/google/news/live/advanced - /apis/v1/dataforseo/serp/google/news/live/html - /apis/v1/dataforseo/serp/google/news/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/news/task_get/html/{id} - /apis/v1/dataforseo/serp/google/news/task_post - /apis/v1/dataforseo/serp/google/news/tasks_ready - /apis/v1/dataforseo/serp/google/organic/live/advanced - /apis/v1/dataforseo/serp/google/organic/live/html - /apis/v1/dataforseo/serp/google/organic/live/regular - /apis/v1/dataforseo/serp/google/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/google/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/google/organic/task_post - /apis/v1/dataforseo/serp/google/organic/tasks_ready - /apis/v1/dataforseo/serp/google/search_by_image/task_get/advanced/{id} - /apis/v1/dataforseo/serp/google/search_by_image/task_get/html/{id} - /apis/v1/dataforseo/serp/google/search_by_image/task_post - /apis/v1/dataforseo/serp/google/search_by_image/tasks_ready - /apis/v1/dataforseo/serp/naver/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/naver/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/naver/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/naver/organic/task_post - /apis/v1/dataforseo/serp/naver/organic/tasks_ready - /apis/v1/dataforseo/serp/screenshot - /apis/v1/dataforseo/serp/seznam/languages - /apis/v1/dataforseo/serp/seznam/locations - /apis/v1/dataforseo/serp/seznam/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/seznam/organic/task_post - /apis/v1/dataforseo/serp/seznam/organic/tasks_ready - /apis/v1/dataforseo/serp/yahoo/languages - /apis/v1/dataforseo/serp/yahoo/locations - /apis/v1/dataforseo/serp/yahoo/organic/live/advanced - /apis/v1/dataforseo/serp/yahoo/organic/live/html - /apis/v1/dataforseo/serp/yahoo/organic/live/regular - /apis/v1/dataforseo/serp/yahoo/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_get/html/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_get/regular/{id} - /apis/v1/dataforseo/serp/yahoo/organic/task_post - /apis/v1/dataforseo/serp/yahoo/organic/tasks_ready - /apis/v1/dataforseo/serp/youtube/languages - /apis/v1/dataforseo/serp/youtube/locations - /apis/v1/dataforseo/serp/youtube/organic/live/advanced - /apis/v1/dataforseo/serp/youtube/organic/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/organic/task_post - /apis/v1/dataforseo/serp/youtube/organic/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_comments/live/advanced - /apis/v1/dataforseo/serp/youtube/video_comments/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_comments/task_post - /apis/v1/dataforseo/serp/youtube/video_comments/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_info/live/advanced - /apis/v1/dataforseo/serp/youtube/video_info/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_info/task_post - /apis/v1/dataforseo/serp/youtube/video_info/tasks_ready - /apis/v1/dataforseo/serp/youtube/video_subtitles/live/advanced - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_get/advanced/{id} - /apis/v1/dataforseo/serp/youtube/video_subtitles/task_post - /apis/v1/dataforseo/serp/youtube/video_subtitles/tasks_ready x-aisa-document: composer_version: '20' document_hash: sha256:247f0a53489bda2c81b4142a1275f7af13128904396e39f2485c6ba921e0d40a facts_hash: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: dataforseo servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/dataforseo/on_page/pages: post: tags: - default summary: OnPage API Pages description: >- This endpoint returns a list of crawled pages with on-page check-ups and other metrics related to the page performance. Using this function you will get page-specific data with detailed information on how well your pages are optimized for search. for more info please visit 'https://docs.dataforseo.com/v3/on_page/pages/?bash' Usage-based billing; Default request estimate: $0.012 USD (not a fixed price). Account-specific pricing and final settlement may differ. operationId: any_dataforseo_apis_v1_dataforseo_on_page_pages requestBody: content: application/json: schema: example: - filters: - - resource_type - '=' - html - and - - meta.scripts_count - '>' - 40 id: 07281559-0695-0216-0000-c269be8b7592 limit: 10 order_by: - meta.content.plain_text_word_count,desc items: oneOf: - example: - filters: - - resource_type - '=' - html - and - - meta.scripts_count - '>' - 40 id: 07281559-0695-0216-0000-c269be8b7592 limit: 10 order_by: - meta.content.plain_text_word_count,desc properties: filters: 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, <, <=, >, >=, =, <>, in, not_in, like, not_likeyou can use the % operator with like and not_like to match any string of zero or more charactersexample:["meta.external_links_count","<=",50]["url","like","https://dataforseo.com/apis/dataforseo-labs-api"][["checks.high_waiting_time","=",false],"and",["resource_type","=","html"]][["page_timing.duration_time","<",100],"and",[["checks.large_page_size","=",false],"or",["checks.high_waiting_time","=",false]]]The full list of possible filters is available by this link. items: type: - object - 'null' type: - array - 'null' id: description: >- ID of the taskrequired fieldyou can get this ID in the response of the Task POST endpointexample:"07131248-1535-0216-1000-17384017ad04" type: string limit: description: >- the maximum number of returned pagesoptional fielddefault value: 100maximum value: 1000 type: - integer - 'null' offset: description: >- offset in the results array of returned pagesoptional fielddefault value: 0maximum value: 2000000if you specify the 10 value, the first ten pages in the results array will be omitted and the data will be provided for the successive pages type: - integer - 'null' order_by: 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 typeexample:["meta.external_links_count,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:["page_timing.dom_complete,asc","size,desc"] items: type: string type: - array - 'null' search_after_token: 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 20,000 results in a single request;by specifying the unique search_after_token value from the response array, you will get the subsequent results of the initial task;search_after_token values are unique for each subsequent task ;Note: if the search_after_token is specified in the request, all other parameters should be identical to the previous request type: - string - 'null' tag: 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 - 'null' type: object type: - object - 'null' type: array responses: '200': content: application/json: schema: oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPagePagesResponseInfo type: - object - 'null' description: Successful operation default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats x-codeSamples: - label: Reference example lang: text source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request POST \ --url https://api.aisa.one/apis/v1/dataforseo/on_page/pages \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '[ { "id": "07281559-0695-0216-0000-c269be8b7592", "filters": [ [ "resource_type", "=", "html" ], "and", [ "meta.scripts_count", ">", 40 ] ], "order_by": [ "meta.content.plain_text_word_count,desc" ], "limit": 10 } ]' components: schemas: Response463397119C53_OnPagePagesResponseInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseInfo' - properties: tasks: description: array of tasks items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPagePagesTaskInfo type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_BaseResponseInfo: properties: cost: description: total tasks cost, USD format: double type: - number - 'null' status_code: description: |- general status code you can find the full list of the response codes here type: - integer - 'null' status_message: description: |- general informational message you can find the full list of general informational messages here type: - string - 'null' tasks_count: description: the number of tasks in the tasks array format: int64 type: - integer - 'null' tasks_error: description: the number of tasks in the tasks array returned with an error format: int64 type: - integer - 'null' time: description: total execution time, seconds type: - string - 'null' version: description: the current version of the API type: - string - 'null' Response463397119C53_OnPagePagesTaskInfo: allOf: - $ref: '#/components/schemas/Response463397119C53_BaseResponseTaskInfo' - properties: result: description: array of results items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPagePagesResultInfo type: - object - 'null' type: - array - 'null' type: object type: object Response463397119C53_BaseResponseTaskInfo: properties: cost: description: total tasks cost, USD format: double type: - number - 'null' data: additionalProperties: type: - object - 'null' description: contains the same parameters that you specified in the POST request type: - object - 'null' id: description: |- task identifier unique task identifier in our system in the UUID format type: - string - 'null' path: description: URL path items: type: - string - 'null' type: - array - 'null' result_count: description: number of elements in the result array format: int64 type: - integer - 'null' status_code: description: >- status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here type: - integer - 'null' status_message: description: |- informational message of the task you can find the full list of general informational messages here type: - string - 'null' time: description: execution time, seconds type: - string - 'null' Response463397119C53_OnPagePagesResultInfo: properties: crawl_progress: description: 'status of the crawling sessionpossible values: in_progress, finished' type: - string - 'null' crawl_status: description: details of the crawling session oneOf: - $ref: '#/components/schemas/Response463397119C53_CrawlStatusInfo' type: - object - 'null' current_offset: type: - integer - 'null' items: description: items array items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_BaseOnPageResourceItem type: - object - 'null' type: - array - 'null' items_count: description: number of items in the results array format: int64 type: - integer - 'null' search_after_token: type: - string - 'null' total_items_count: description: total number of relevant items in the database format: int64 type: - integer - 'null' type: object Response463397119C53_CrawlStatusInfo: properties: max_crawl_pages: description: |- maximum number of pages to crawl indicates the max_crawl_pages limit you specified when setting a task format: int64 type: - integer - 'null' pages_crawled: description: number of crawled pages format: int64 type: - integer - 'null' pages_in_queue: description: number of pages that are currently in the crawling queue format: int64 type: - integer - 'null' type: object Response463397119C53_BaseOnPageResourceItem: additionalProperties: false discriminator: mapping: broken: '#/components/schemas/Response463397119C53_OnPageBrokenResourceItem' html: '#/components/schemas/Response463397119C53_OnPageHtmlResourceItem' image: '#/components/schemas/Response463397119C53_OnPageImageResourceItem' redirect: '#/components/schemas/Response463397119C53_OnPageRedirectResourceItem' script: '#/components/schemas/Response463397119C53_OnPageScriptResourceItem' stylesheet: >- #/components/schemas/Response463397119C53_OnPageStylesheetResourceItem propertyName: resource_type properties: cache_control: description: instructions for caching oneOf: - $ref: '#/components/schemas/Response463397119C53_CacheControl' type: - object - 'null' checks: additionalProperties: type: - boolean - 'null' description: website checkson-page check-ups related to the page type: - object - 'null' content_encoding: description: type of encoding type: - string - 'null' encoded_size: description: >- page size after encodingindicates the size of the encoded page measured in bytes type: - integer - 'null' fetch_time: description: >- date and time when a resource was fetchedin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”example:2019-11-15 12:57:46 +00:00 type: - string - 'null' last_modified: description: >- contains data on changes related to the resourceif there is no data, the value will be null oneOf: - $ref: '#/components/schemas/Response463397119C53_LastModified' type: - object - 'null' location: description: location headerindicates the URL to redirect a page to type: - string - 'null' media_type: description: types of media used to display a page type: - string - 'null' resource_errors: description: resource errors and warnings oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPageResourceIssueInfo type: - object - 'null' resource_type: description: type of element type: - string - 'null' server: description: server version type: - string - 'null' size: description: resource sizeindicates the size of a given page measured in bytes type: - integer - 'null' status_code: description: >- general status codeyou can find the full list of the response codes hereNote: we strongly recommend designing a necessary system for handling related exceptional or error conditions type: - integer - 'null' total_transfer_size: description: compressed page sizeindicates the compressed size of a given page format: int64 type: - integer - 'null' url: description: page URL type: - string - 'null' type: object Response463397119C53_OnPageBrokenResourceItem: allOf: - oneOf: - $ref: '#/components/schemas/Response463397119C53_BaseOnPageResourceItem' type: - object - 'null' - properties: accept_type: description: >- indicates the expected type of resource
for example, if "resource_type": "broken", accept_type will indicate the type of the broken resource
possible values:
any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font type: - string - 'null' fetch_timing: description: time range within which a result was fetched oneOf: - $ref: '#/components/schemas/Response463397119C53_FetchTiming' type: - object - 'null' is_resource: description: indicates whether a page is a single resource type: - boolean - 'null' meta: description: >- resource properties
the value depends on the resource_type
note that if you do not indicate a url when setting a task, resource's meta is returned based on the data from the page where our crawler first saw the resource;
to obtain resource's meta from a particular url, specify that URL when setting a task oneOf: - $ref: '#/components/schemas/Response463397119C53_PageMetaInfo' type: - object - 'null' type: object type: object Response463397119C53_OnPageHtmlResourceItem: allOf: - oneOf: - $ref: '#/components/schemas/Response463397119C53_BaseOnPageResourceItem' type: - object - 'null' - properties: broken_links: description: indicates whether a page contains broken links type: - boolean - 'null' broken_resources: description: indicates whether a page contains broken resources type: - boolean - 'null' click_depth: description: >- number of clicks it takes to get to the pageindicates the number of clicks from the homepage needed before landing at the target page type: - integer - 'null' custom_js_client_exception: description: >- error when executing a custom jsif the error occurred when executing the script you specified in the custom_js field, the error message would be displayed here type: - string - 'null' custom_js_response: description: >- the result of executing a specified JS scriptnote that you should specify a custom_js field when setting a task to receive this data and the field type and its value will totally depend on the script you specified;you can also filter the results by this value specifying filters in the following way:["custom_js_response.url", "like", "pixel"] type: - object - 'null' duplicate_content: description: indicates whether a page has duplicate content type: - boolean - 'null' duplicate_description: description: indicates whether a page has a duplicate description type: - boolean - 'null' duplicate_title: description: indicates whether a page has duplicate title tags type: - boolean - 'null' is_resource: description: indicates whether a page is a single resource type: - boolean - 'null' meta: description: page propertiesthe value depends on the resource_type oneOf: - $ref: '#/components/schemas/Response463397119C53_PageMetaInfo' properties: broken_html: description: resource errors and warnings oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPageResourceIssueInfo type: - object - 'null' social_media_tags: additionalProperties: type: - string - 'null' type: - object - 'null' type: - object - 'null' onpage_score: description: >- shows how page is optimized on a 100-point scalethis field shows how page is optimized considering critical on-page issues and warnings detected;100 is the highest possible score that means the page does not have any critical on-page issues and important warnings;learn more about how the metric is calculated in this help center article type: - number - 'null' page_timing: description: object of page load metrics oneOf: - $ref: '#/components/schemas/Response463397119C53_PageTiming' type: - object - 'null' relative_url_length: description: relative URL length in characters type: - integer - 'null' total_dom_size: description: total DOM size of a page format: int64 type: - integer - 'null' url_length: description: page URL length in characters type: - integer - 'null' type: object type: object Response463397119C53_OnPageImageResourceItem: allOf: - oneOf: - $ref: '#/components/schemas/Response463397119C53_BaseOnPageResourceItem' type: - object - 'null' - properties: accept_type: description: >- indicates the expected type of resourcefor example, if "resource_type": "broken", accept_type will indicate the type of the broken resourcepossible values:any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font type: - string - 'null' fetch_timing: description: time range within which a result was fetched oneOf: - $ref: '#/components/schemas/Response463397119C53_FetchTiming' type: - object - 'null' meta: description: page propertiesthe value depends on the resource_type oneOf: - $ref: '#/components/schemas/Response463397119C53_ResourceMetaInfo' type: - object - 'null' type: object type: object Response463397119C53_OnPageRedirectResourceItem: allOf: - oneOf: - $ref: '#/components/schemas/Response463397119C53_BaseOnPageResourceItem' type: - object - 'null' - properties: fetch_timing: description: time range within which a result was fetched oneOf: - $ref: '#/components/schemas/Response463397119C53_FetchTiming' type: - object - 'null' is_resource: description: indicates whether a page is a single resource type: - boolean - 'null' type: object type: object Response463397119C53_OnPageScriptResourceItem: allOf: - oneOf: - $ref: '#/components/schemas/Response463397119C53_BaseOnPageResourceItem' type: - object - 'null' - properties: accept_type: description: >- indicates the expected type of resourcefor example, if "resource_type": "broken", accept_type will indicate the type of the broken resourcepossible values:any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font type: - string - 'null' fetch_timing: description: time range within which a result was fetched oneOf: - $ref: '#/components/schemas/Response463397119C53_FetchTiming' type: - object - 'null' meta: oneOf: - $ref: '#/components/schemas/Response463397119C53_ResourceMetaInfo' type: - object - 'null' type: object type: object Response463397119C53_OnPageStylesheetResourceItem: allOf: - oneOf: - $ref: '#/components/schemas/Response463397119C53_BaseOnPageResourceItem' type: - object - 'null' - properties: accept_type: description: >- indicates the expected type of resourcefor example, if "resource_type": "broken", accept_type will indicate the type of the broken resourcepossible values:any, none, image, sitemap, robots, script, stylesheet, redirect, html, text, other, font type: - string - 'null' fetch_timing: description: time range within which a result was fetched oneOf: - $ref: '#/components/schemas/Response463397119C53_FetchTiming' type: - object - 'null' meta: description: page propertiesthe value depends on the resource_type oneOf: - $ref: '#/components/schemas/Response463397119C53_ResourceMetaInfo' type: - object - 'null' type: object type: object Response463397119C53_CacheControl: properties: cachable: description: indicates whether the page is cacheable type: - boolean - 'null' ttl: description: time to livethe amount of time the browser caches a resource type: - integer - 'null' type: object Response463397119C53_LastModified: properties: header: description: >- date and time when the header was last modifiedin the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"example:2019-11-15 12:57:46 +00:00if there is no data, the value will be null type: - string - 'null' meta_tag: description: >- date and time when the meta tag was last modifiedin the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"example:2019-11-15 12:57:46 +00:00if there is no data, the value will be null type: - string - 'null' sitemap: description: >- date and time when the sitemap was last modifiedin the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"example:2019-11-15 12:57:46 +00:00if there is no data, the value will be null type: - string - 'null' type: object Response463397119C53_OnPageResourceIssueInfo: description: resource errors and warnings properties: errors: description: resource errors items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPageResourceIssueItemInfo type: - object - 'null' type: - array - 'null' warnings: description: resource warnings items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPageResourceIssueItemInfo type: - object - 'null' type: - array - 'null' type: object Response463397119C53_FetchTiming: properties: duration_time: description: >- total time it takes until a browser receives a complete response from a server (in milliseconds) type: - integer - 'null' fetch_end: description: >- time to complete downloading the HTML resourcethe amount of time the browser needs to complete downloading a page type: - integer - 'null' fetch_start: description: >- time to start downloading the HTML resourcethe amount of time the browser needs to start downloading a page type: - integer - 'null' type: object Response463397119C53_PageMetaInfo: properties: broken_html: description: resource errors and warnings oneOf: - $ref: >- #/components/schemas/Response463397119C53_OnPageResourceIssueInfo type: - object - 'null' canonical: description: canonical page type: - string - 'null' charset: description: 'code pageexample: 65001' type: - integer - 'null' content: description: overall information about content of the page oneOf: - $ref: '#/components/schemas/Response463397119C53_HtmlContentInfo' type: - object - 'null' cumulative_layout_shift: description: >- Core Web Vitals metric measuring the layout stability of the pagemeasures the sum total of all individual layout shift scores for every unexpected layout shift that occurs during the entire lifespan of the page. Learn more. type: - number - 'null' deprecated_tags: description: deprecated tags on the page items: type: - string - 'null' type: - array - 'null' description: description: content of the meta description tag type: - string - 'null' description_length: description: length of the description tag in characters type: - integer - 'null' duplicate_meta_tags: description: duplicate meta tags on the page items: type: - string - 'null' type: - array - 'null' external_links_count: description: number of external links on the page format: int64 type: - integer - 'null' favicon: description: favicon of the page type: - string - 'null' follow: description: >- indicates whether a page's 'meta robots' allows crawlers to follow the links on the pageif false, the page's 'meta robots' tag contains "nofollow" parameter instructing crawlers not to follow the links on the page type: - boolean - 'null' generator: description: meta tag generator type: - string - 'null' htags: additionalProperties: items: type: string type: - array - 'null' description: HTML header tags type: - object - 'null' images_count: description: number of images on the page format: int64 type: - integer - 'null' images_size: description: total size of images on the page measured in bytes type: - integer - 'null' inbound_links_count: description: number of internal links pointing at the page format: int64 type: - integer - 'null' internal_links_count: description: number of internal links on the page format: int64 type: - integer - 'null' meta_keywords: description: content of the keywords meta tag type: - string - 'null' meta_title: description: >- meta title of the pagemeta tag in the head section of an HTML document that defines the title of a page type: - string - 'null' render_blocking_scripts_count: description: number of scripts on the page that block page rendering format: int64 type: - integer - 'null' render_blocking_stylesheets_count: description: number of CSS styles on the page that block page rendering format: int64 type: - integer - 'null' scripts_count: description: number of scripts on the page format: int64 type: - integer - 'null' scripts_size: description: total size of scripts on the page measured in bytes type: - integer - 'null' social_media_tags: additionalProperties: type: - string - 'null' description: >- object of social media tags found on the pagecontains social media tags and their contentsupported tags include but are not limited to Open Graph and Twitter card type: - object - 'null' spell: description: spellcheckhunspell spellcheck errors oneOf: - $ref: '#/components/schemas/Response463397119C53_HunspellInfo' type: - object - 'null' stylesheets_count: description: number of stylesheets on the page format: int64 type: - integer - 'null' stylesheets_size: description: total size of stylesheets on the page measured in bytes type: - integer - 'null' title: description: page title type: - string - 'null' title_length: description: length of the title tag in characters type: - integer - 'null' type: object Response463397119C53_PageTiming: properties: connection_time: description: >- time to connect to a serverthe time it takes until the connection with a server is established (in milliseconds) type: - integer - 'null' dom_complete: description: >- time to load resourcesthe time it takes until the page and all of its subresources are downloaded (in milliseconds) type: - integer - 'null' download_time: description: time it takes for a browser to receive a response (in milliseconds) type: - integer - 'null' duration_time: description: >- total time it takes until a browser receives a complete response from a server (in milliseconds) type: - integer - 'null' fetch_end: description: >- time to complete downloading the HTML resourcethe amount of time the browser needs to complete downloading a page type: - integer - 'null' fetch_start: description: >- time to start downloading the HTML resourcethe amount of time the browser needs to start downloading a page type: - integer - 'null' first_input_delay: description: >- Core Web Vitals metric indicating the responsiveness of a pageThe time (in milliseconds) from when a user first interacts with your page to the time when the browser responds to that interaction. Learn more. type: - number - 'null' largest_contentful_paint: description: >- Core Web Vitals metric measuring how fast the largest above-the-fold content element is displayedThe amount of time (in milliseconds) to render the largest content element visible in the viewport, from when the user requests the URL. Learn more. type: - number - 'null' request_sent_time: description: >- time to send a request to a serverthe time it takes until the request to a server is sent (in milliseconds) type: - integer - 'null' time_to_interactive: description: >- Time To Interactive (TTI) metricthe time it takes until the user can interact with a page (in milliseconds) type: - integer - 'null' time_to_secure_connection: description: >- time to establish a secure connectionthe time it takes until the secure connection with a server is established (in milliseconds) type: - integer - 'null' waiting_time: description: time to first byte (TTFB) in milliseconds type: - integer - 'null' type: object Response463397119C53_ResourceMetaInfo: properties: alternative_text: description: content of the image alt attribute type: - string - 'null' height: description: image height in px format: double type: - number - 'null' original_height: description: original image height in px format: double type: - number - 'null' original_width: description: original image width in px format: double type: - number - 'null' title: description: title type: - string - 'null' width: description: image width in px format: double type: - number - 'null' type: object Response463397119C53_OnPageResourceIssueItemInfo: properties: column: description: column where the error was found type: - integer - 'null' line: description: line where the error was found type: - integer - 'null' message: description: >- text message of the errorthe full list of possible HTML errors can be found here type: - string - 'null' status_code: description: >- general status codeyou can find the full list of the response codes hereNote: we strongly recommend designing a necessary system for handling related exceptional or error conditions type: - integer - 'null' type: object Response463397119C53_HtmlContentInfo: properties: automated_readability_index: description: Automated Readability Index type: - number - 'null' coleman_liau_readability_index: description: Coleman–Liau Index type: - number - 'null' dale_chall_readability_index: description: Dale–Chall Readability Index type: - number - 'null' description_to_content_consistency: description: >- consistency of the meta description tag with the page contentmeasured from 0 to 1 type: - number - 'null' flesch_kincaid_readability_index: description: Flesch–Kincaid Readability Index type: - number - 'null' meta_keywords_to_content_consistency: description: >- consistency of meta keywordstag with the page contentmeasured from 0 to 1 type: - number - 'null' plain_text_rate: description: |- plaintext rate value plain_text_size to size ratio format: double type: - number - 'null' plain_text_size: description: total size of the text on the page measured in bytes type: - integer - 'null' plain_text_word_count: description: number of words on the page type: - integer - 'null' smog_readability_index: description: SMOG Readability Index type: - number - 'null' title_to_content_consistency: description: >- consistency of the meta title tag with the page contentmeasured from 0 to 1 type: - number - 'null' type: object Response463397119C53_HunspellInfo: properties: hunspell_language_code: description: spellcheck language code type: - string - 'null' misspelled: description: array of misspelled words items: oneOf: - $ref: >- #/components/schemas/Response463397119C53_HunspellMisspelledInfo type: - object - 'null' type: - array - 'null' type: object Response463397119C53_HunspellMisspelledInfo: properties: word: description: misspelled word type: - string - 'null' type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.