{ "openapi": "3.0.1", "info": { "title": "Semrush Scraper", "description": "Get Semrush data for any list of websites: Authority Score, organic and paid traffic, backlinks, referring domains, ranks, top keywords, competitors and AI traffic. Plus top websites by country and industry.", "version": "0.1", "x-build-id": "k1Kw9h9VfvZ7iFnbW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automly~semrush-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automly-semrush-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automly~semrush-scraper/runs": { "post": { "operationId": "runs-sync-automly-semrush-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automly~semrush-scraper/run-sync": { "post": { "operationId": "run-sync-automly-semrush-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "domains": { "title": "Websites", "type": "array", "description": "Websites to look up, e.g. nike.com or https://www.stripe.com/. One per line; each gives one row with its Authority Score, traffic, backlinks, top keywords and competitors. Pages and subdomains are read as their main website.", "items": { "type": "string" } }, "topWebsitesCountries": { "title": "Countries", "type": "array", "description": "Countries to list the top websites of, e.g. United States or Worldwide. Leave empty to skip top websites.", "items": { "type": "string", "enum": [ "global", "af", "ax", "al", "dz", "as", "ad", "ao", "ai", "aq", "ag", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "by", "be", "bz", "bj", "bm", "bt", "bo", "bq", "ba", "bw", "bv", "br", "io", "vg", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "ky", "cf", "td", "cl", "cn", "cx", "cc", "co", "km", "ck", "cr", "ci", "hr", "cw", "cy", "cz", "cd", "dk", "dj", "dm", "do", "tl", "ec", "eg", "sv", "gq", "er", "ee", "et", "fk", "fo", "fj", "fi", "fr", "gf", "pf", "ga", "gm", "ge", "de", "gh", "gi", "gr", "gl", "gd", "gp", "gu", "gt", "gg", "gn", "gw", "gy", "ht", "hm", "hn", "hk", "hu", "is", "in", "id", "iq", "ie", "im", "il", "it", "jm", "jp", "je", "jo", "kz", "ke", "ki", "kw", "kg", "la", "lv", "lb", "ls", "lr", "li", "lt", "lu", "mo", "mk", "mg", "mw", "my", "mv", "ml", "mt", "mh", "mq", "mr", "mu", "yt", "mx", "fm", "md", "mc", "mn", "me", "ms", "ma", "mz", "na", "nr", "np", "nl", "nc", "nz", "ni", "ne", "ng", "nu", "nf", "mp", "no", "om", "pk", "pw", "ps", "pa", "pg", "py", "pe", "ph", "pl", "pt", "pr", "qa", "cg", "re", "ro", "ru", "rw", "bl", "sh", "kn", "lc", "mf", "pm", "vc", "ws", "sm", "st", "sa", "sn", "rs", "sc", "sl", "sg", "sx", "sk", "si", "sb", "so", "za", "gs", "kr", "ss", "es", "lk", "sr", "sj", "sz", "se", "ch", "tw", "tj", "tz", "th", "tg", "tk", "to", "tt", "tn", "tr", "tm", "tc", "tv", "ug", "ua", "ae", "gb", "us", "vi", "uy", "uz", "vu", "va", "ve", "vn", "wf", "eh", "ye", "zm", "zw" ], "enumTitles": [ "Worldwide", "Afghanistan", "Aland", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua And Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Sint Eustatius And Saba", "Bosnia And Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos Islands", "Colombia", "Comoros", "Cook Islands", "Costa Rica", "Cote d'Ivoire", "Croatia", "Curacao", "Cyprus", "Czech Republic", "Democratic Republic Of The Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands", "Faroes", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea Bissau", "Guyana", "Haiti", "Heard Island And McDonald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iraq", "Ireland", "Isle Of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic Of The Congo", "Reunion", "Romania", "Russia", "Rwanda", "Saint Barthelemy", "Saint Helena", "Saint Kitts And Nevis", "Saint Lucia", "Saint Martin", "Saint Pierre and Miquelon", "Saint Vincent And The Grenadines", "Samoa", "San Marino", "Sao Tome And Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia And The South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Suriname", "Svalbard And Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tokelau", "Tonga", "Trinidad And Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks And Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Virgin Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis And Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" ] }, "default": [] }, "topWebsitesIndustries": { "title": "Industries", "type": "array", "description": "Industries to list for each country, e.g. All industries or Finance. Each country and industry pair gives up to 100 websites ranked by monthly visits.", "items": { "type": "string", "enum": [ "all", "accounting-and-auditing", "adult", "advertising-and-marketing", "aerospace-and-defense", "agriculture", "airlines", "apparel-and-fashion", "architecture", "automotive", "banking", "beauty-and-cosmetics", "biotech", "ceramics-and-pottery", "chemicals", "civil-engineering", "comics-and-animation", "computer-and-video-games", "computer-hardware", "computer-software-and-development", "computers-and-electronics", "construction-and-maintenance", "consulting", "consumer-electronics", "crafts", "customer-services", "design", "distance-learning", "ecology-and-environment", "education", "entertainment", "equipment-and-supplies", "events-services", "facilities-services", "farms-and-ranches", "finance", "fishery", "food-and-beverages", "foreign-language", "furniture", "gambling", "government", "graphic-design", "healthcare", "hospitality", "human-resources", "import-and-export", "information-technology", "insurance", "investment", "jewelry-and-luxury-products", "legal", "libraries", "machinery", "mail-and-package-delivery", "manufacturing", "maritime", "market-research", "mass-media", "medical-devices-and-equipment", "mental-health", "metals-and-mining", "military", "museums", "music", "nanotechnology", "newspapers", "nonprofit-organizations", "oil-and-gas", "online-services", "outsourcing", "packaging-and-containers", "performing-arts", "pharmaceuticals", "photography", "plastics-and-polymers", "political-organizations", "printing", "public-policy", "public-relations", "public-safety", "public-utility", "publishing", "real-estate", "recreational-facilities", "recruitment-and-staffing", "reference", "religion-and-belief", "renewable-energy", "restaurants", "retail", "science", "security-products-and-services", "social-and-charitable-organizations", "sporting-goods", "sports", "telecom", "textiles-and-nonwovens", "tobacco", "training-and-certification", "transportation-and-logistics", "travel-and-tourism", "tv-and-movies", "venture-capital", "veterinary", "visual-art", "warehousing", "wellness", "wholesalers-and-liquidators", "wine-and-spirits", "writing-and-editing-services" ], "enumTitles": [ "All industries", "Accounting & Auditing", "Adult", "Advertising & Marketing", "Aerospace & Defense", "Agriculture", "Airlines", "Apparel & Fashion", "Architecture", "Automotive", "Banking", "Beauty & Cosmetics", "Biotech", "Ceramics & Pottery", "Chemicals", "Civil Engineering", "Comics & Animation", "Computer & Video Games", "Computer Hardware", "Computer Software & Development", "Computers & Electronics", "Construction & Maintenance", "Consulting", "Consumer Electronics", "Crafts", "Customer Services", "Design", "Distance Learning", "Ecology & Environment", "Education", "Entertainment", "Equipment & Supplies", "Events Services", "Facilities Services", "Farms & Ranches", "Finance", "Fishery", "Food & Beverages", "Foreign Language", "Furniture", "Gambling", "Government", "Graphic Design", "Healthcare", "Hospitality", "Human Resources", "Import & Export", "Information Technology", "Insurance", "Investment", "Jewelry & Luxury Products", "Legal", "Libraries", "Machinery", "Mail & Package Delivery", "Manufacturing", "Maritime", "Market Research", "Mass Media", "Medical Devices & Equipment", "Mental Health", "Metals & Mining", "Military", "Museums", "Music", "Nanotechnology", "Newspapers", "Nonprofit Organizations", "Oil & Gas", "Online Services", "Outsourcing", "Packaging & Containers", "Performing Arts", "Pharmaceuticals", "Photography", "Plastics & Polymers", "Political Organizations", "Printing", "Public Policy", "Public Relations", "Public Safety", "Public Utility", "Publishing", "Real Estate", "Recreational Facilities", "Recruitment & Staffing", "Reference", "Religion & Belief", "Renewable Energy", "Restaurants", "Retail", "Science", "Security Products & Services", "Social & Charitable Organizations", "Sporting Goods", "Sports", "Telecom", "Textiles & Nonwovens", "Tobacco", "Training & Certification", "Transportation & Logistics", "Travel & Tourism", "Tv & Movies", "Venture Capital", "Veterinary", "Visual Art", "Warehousing", "Wellness", "Wholesalers & Liquidators", "Wine & Spirits", "Writing & Editing Services" ] }, "default": [ "all" ] }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy works out of the box.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }