# UK Trade Leads: Verified Tradespeople Contacts & Phones (`vulnv/uk-trade-leads`) Actor Generate UK tradespeople leads by area and profession. Get company names, phone numbers, ratings, reviews, websites and locations - ready for outreach, lead generation and market research. - **URL**: https://apify.com/vulnv/uk-trade-leads.md - **Developed by:** [VulnV](https://apify.com/vulnv) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $18.40 / 1,000 leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## UK Trade Leads Generate ready-to-use **UK tradespeople leads** by area and profession. Pick a UK area and a trade, and the actor returns a clean list of businesses with their contact details - ideal for outreach, lead generation, market research and competitor analysis. ### What you get One row per tradesperson lead: | Field | Description | |-------|-------------| | `businessName` | Trading name of the business | | `phone` | Contact phone number | | `websiteUrl` | Business website (when listed) | | `profileId` | Stable profile identifier | | `address` | Locality / region | | `postalCode` | Postcode / area served | | `rating` | Average review score | | `reviewCount` | Number of reviews | | `ownerName` | Business owner (when listed) | | `vatRegistered` | VAT registration status | | `companyType` | Limited company / sole trader | | `profession` | The trade searched for | | `area` | The area searched | | `isSponsored` | Whether the listing is promoted | ### Input - **Area** - a UK city, postcode or postcode area (e.g. `Manchester`, `M1`, `GL1`). - **Profession** - the trade to find (e.g. Builder, Plumber, Electrician, Roofer). Hundreds of trades and sub-trades are available. - **Maximum Pages** - how many result pages to collect (each page ≈ 20 leads). Set `0` for no limit. - **Require Phone Number** - only return leads that include a phone number. ### Example ```json { "location": "M1", "category": "2", "max_pages": 2, "require_phone_number": true } ```` Returns UK **Builders** around **Manchester (M1)** that have a phone number. ### Pricing Pay per lead returned. You are only charged for leads delivered to your dataset. ### Notes This actor collects publicly available UK business listing information. It is an independent tool and is **not** affiliated with, endorsed by, or connected to any third-party directory or platform. All trademarks belong to their respective owners. # Actor input Schema ## `location` (type: `string`): The UK area to find trade leads in. Use a city, postcode or postcode area (e.g., 'Gloucester', 'GL', 'GL1'). ## `max_pages` (type: `integer`): The maximum number of pages to scrape (each page contains up to 20 tradespeople). Set to 0 for no limit. ## `category` (type: `string`): Select the trade / profession to find leads for. ## `require_phone_number` (type: `boolean`): When enabled, only leads that include a phone number are returned. ## Actor input object example ```json { "location": "e6 1ae", "max_pages": 1, "category": "2", "require_phone_number": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "max_pages": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("vulnv/uk-trade-leads").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "max_pages": 1 } # Run the Actor and wait for it to finish run = client.actor("vulnv/uk-trade-leads").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "max_pages": 1 }' | apify call vulnv/uk-trade-leads --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vulnv/uk-trade-leads", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Trade Leads: Verified Tradespeople Contacts & Phones", "description": "Generate UK tradespeople leads by area and profession. Get company names, phone numbers, ratings, reviews, websites and locations - ready for outreach, lead generation and market research.", "version": "1.0", "x-build-id": "60XPY4IV6ESQgw1Wd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vulnv~uk-trade-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vulnv-uk-trade-leads", "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/vulnv~uk-trade-leads/runs": { "post": { "operationId": "runs-sync-vulnv-uk-trade-leads", "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/vulnv~uk-trade-leads/run-sync": { "post": { "operationId": "run-sync-vulnv-uk-trade-leads", "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", "required": [ "location", "category" ], "properties": { "location": { "title": "Area", "type": "string", "description": "The UK area to find trade leads in. Use a city, postcode or postcode area (e.g., 'Gloucester', 'GL', 'GL1').", "default": "e6 1ae" }, "max_pages": { "title": "Maximum Pages", "type": "integer", "description": "The maximum number of pages to scrape (each page contains up to 20 tradespeople). Set to 0 for no limit.", "default": 0 }, "category": { "title": "Profession", "enum": [ "834", "1570", "1693", "1326", "1409", "1694", "1932", "836", "1169", "835", "1171", "1430", "1002", "1004", "1366", "1620", "1930", "1003", "1456", "1369", "1160", "1651", "1549", "1928", "1161", "1162", "1163", "1548", "667", "1432", "1688", "668", "1655", "1457", "1927", "1431", "1458", "1459", "1180", "1460", "706", "707", "708", "1172", "1647", "1318", "1871", "1174", "1683", "1173", "1678", "1175", "1700", "1176", "2018", "2019", "1648", "1684", "1937", "2017", "1021", "1022", "1480", "1023", "1556", "1025", "1539", "1361", "1027", "1914", "1975", "2003", "2002", "2059", "2061", "1874", "1024", "1355", "1028", "1026", "1652", "1319", "1360", "1610", "1348", "1894", "1701", "1292", "2004", "2058", "2060", "1029", "1342", "1030", "1411", "1383", "1033", "1302", "1031", "1303", "1032", "1034", "1915", "1045", "1698", "1049", "1531", "1047", "1254", "1722", "2", "1251", "1245", "1517", "42", "1417", "1600", "883", "1019", "90", "1384", "1606", "102", "1696", "1418", "1605", "135", "1613", "1518", "1395", "198", "686", "1059", "1533", "1496", "1580", "1307", "1359", "1893", "1590", "1055", "200", "1498", "1557", "1057", "1060", "1061", "1519", "1601", "1602", "1353", "1920", "1423", "1011", "1422", "1644", "1516", "1951", "1337", "1429", "1012", "1338", "1529", "1241", "1013", "21", "1635", "157", "787", "1435", "1476", "225", "261", "155", "1550", "789", "1663", "1952", "2005", "2006", "2007", "1138", "2072", "2076", "1151", "1569", "1152", "1404", "1403", "1596", "1405", "2067", "2068", "1156", "1479", "1367", "1729", "1158", "1157", "1153", "1154", "1155", "1434", "1421", "1682", "1406", "1950", "1809", "1811", "1810", "1812", "1862", "1876", "1881", "1879", "1877", "1880", "1878", "1960", "2083", "19", "149", "1964", "922", "150", "1440", "2009", "2010", "7", "1183", "1576", "1393", "1408", "300", "958", "1325", "1588", "1721", "126", "1344", "1883", "1186", "1559", "1185", "1490", "1687", "1491", "1492", "1187", "1387", "1654", "926", "66", "1965", "1667", "1577", "1184", "1554", "1629", "1394", "1509", "1675", "1680", "1623", "1674", "1540", "1730", "1882", "1611", "1386", "1385", "1650", "1887", "1362", "1329", "847", "1609", "924", "1372", "256", "1646", "9", "294", "1381", "1673", "1182", "874", "952", "244", "52", "1544", "1354", "58", "1912", "1330", "1911", "1331", "1332", "11", "1503", "1201", "100", "1538", "1315", "1202", "1686", "1462", "1586", "1692", "108", "1546", "1585", "1595", "1205", "1903", "1902", "1425", "1536", "1534", "1521", "1864", "613", "1203", "1992", "1987", "1989", "1991", "1998", "1997", "1999", "2000", "2081", "1970", "1461", "1625", "1370", "1555", "28", "1504", "1634", "107", "814", "1537", "1463", "1363", "1708", "1612", "1661", "1471", "1513", "1535", "29", "179", "1909", "1983", "1985", "1986", "1990", "1988", "1993", "1994", "1995", "1996", "2001", "2082", "1388", "1390", "1392", "1391", "1389", "1924", "1177", "1178", "1473", "1474", "1660", "1921", "1670", "988", "989", "990", "1304", "991", "1472", "1918", "1293", "1225", "1906", "1339", "1530", "1181", "1954", "762", "1301", "1426", "1427", "1428", "1300", "6", "1493", "1413", "580", "1234", "1895", "1268", "1494", "1269", "1526", "950", "796", "588", "695", "673", "1371", "1942", "1105", "1451", "1452", "1108", "1453", "1107", "1448", "1449", "1447", "1450", "1106", "1941", "2062", "5", "1212", "1259", "291", "274", "1216", "1592", "1618", "1442", "1215", "1412", "1632", "1226", "1958", "1213", "1560", "1669", "1441", "1485", "610", "1211", "2070", "2075", "1828", "1832", "1945", "1617", "1830", "1831", "1833", "22", "604", "1444", "1467", "1466", "1532", "850", "1725", "597", "160", "133", "1946", "1904", "1978", "1980", "1443", "1604", "1898", "697", "32", "1551", "1522", "1086", "1584", "1979", "2064", "1066", "1399", "1364", "1068", "1396", "1071", "1728", "1527", "1575", "1069", "1067", "1511", "1668", "1884", "1070", "1072", "1955", "1120", "1714", "1257", "1122", "1948", "1715", "1713", "1258", "1121", "875", "1410", "1054", "2011", "2014", "2015", "2016", "882", "1520", "878", "1420", "2012", "2013", "2069", "1734", "1888", "1750", "1751", "1758", "1759", "1762", "1766", "1767", "1768", "1769", "1773", "1775", "1781", "1789", "1947", "1905", "1737", "1746", "1747", "1748", "1776", "1777", "1778", "1793", "1800", "10", "1321", "134", "173", "88", "1093", "1567", "852", "172", "1322", "1974", "1981", "1982", "187", "1335", "1866", "1865", "945", "1933", "1973", "1976", "1050", "1482", "1052", "1892", "1481", "1053", "1578", "1051", "1250", "1943", "1114", "1931", "1373", "1374", "1867", "1873", "1872", "1869", "1868", "1929", "1870", "1813", "1817", "1825", "1827", "1840", "1843", "1844", "1845", "1818", "1815", "1826", "1837", "1839", "1014", "1574", "1718", "1500", "1666", "1645", "1628", "1016", "1246", "1499", "1573", "1572", "1699", "1398", "1015", "1925", "15", "1263", "801", "802", "46", "800", "1614", "139", "81", "819", "803", "611", "1159", "1228", "1298", "1401", "1707", "1940", "855", "856", "857", "862", "1685", "1637", "1563", "1571", "865", "1568", "859", "1497", "861", "1705", "1703", "1284", "1253", "863", "1653", "864", "1679", "1890", "923", "20", "1671", "1723", "151", "221", "1591", "623", "153", "245", "1510", "2020", "2022", "2025", "1672", "1891", "1306", "1334", "1094", "844", "828", "1512", "248", "1939", "2026", "2027", "2021", "2023", "2024", "1164", "1310", "1165", "1465", "1487", "1166", "1968", "1938", "1167", "1168", "1313", "1189", "1505", "1198", "1506", "1608", "1194", "1545", "1192", "1528", "1191", "1615", "1380", "1200", "1193", "1454", "1190", "1196", "1717", "1197", "1936", "2032", "2037", "2044", "2035", "2039", "2040", "2041", "2047", "2052", "2051", "2066", "1542", "1244", "1199", "1543", "1697", "1195", "1242", "1541", "1633", "1702", "1415", "1616", "1640", "1455", "2033", "2043", "2034", "2036", "2038", "2046", "2042", "2045", "2054", "2053", "2048", "2049", "2050", "2055", "2056", "13", "1900", "1690", "1716", "1077", "1073", "1861", "1621", "1080", "241", "1922", "1622", "70", "1078", "1079", "1724", "646", "264", "701", "1081", "761", "702", "14", "266", "1899", "1092", "1507", "1710", "1090", "1726", "1419", "1594", "1143", "1142", "1340", "1720", "1727", "1630", "1579", "1709", "1091", "1087", "176", "1089", "1508", "1926", "2063", "1109", "1934", "1907", "1923", "1127", "1478", "1312", "1125", "1131", "1137", "1704", "1327", "1130", "1134", "1126", "1136", "1433", "1502", "1514", "1597", "1400", "1133", "1343", "1598", "1336", "1885", "1382", "1139", "1132", "1967", "1969", "1662", "1582", "1589", "1128", "1681", "1129", "1135", "1558", "1896", "1599", "1141", "1501", "1291", "1477", "1641", "1886", "1368", "1515", "1711", "1935", "1966", "757", "1913", "1971", "1977", "1972", "1802", "1863", "1804", "1805", "1807", "1806", "1803", "1808", "1035", "1037", "1607", "1916", "1483", "1036", "1038", "1041", "1875", "1039", "1040", "1552", "1044", "1042", "1897", "1917", "2080", "1043", "1379", "93", "1565", "1695", "721", "1919", "24", "59", "1314", "777", "778", "750", "763", "717", "1953", "1908", "774", "132", "110", "1691", "1719", "62", "64", "786", "1407", "1603", "804", "1140", "1910", "12", "1378", "114", "1437", "1438", "87", "1583", "1376", "1547", "1402", "1475", "587", "1657", "797", "154", "1665", "1643", "1959", "2030", "2065", "1377", "193", "1375", "78", "1495", "1486", "1436", "1642", "85", "614", "205", "2028", "2031", "2029", "1207", "1638", "1524", "1439", "1210", "1468", "1961", "1469", "1209", "1208", "1706", "1523", "1095", "1096", "1283", "1636", "1097", "1624", "1098", "1365", "1099", "1100", "1101", "1962", "1110", "1317", "1113", "1111", "1963", "1112", "1627", "17", "618", "1731", "1677", "2008", "837", "1901", "142", "1489", "839", "1732", "1488", "1639", "141", "1944", "1294", "2074", "2077", "2078", "1115", "1346", "1116", "262", "1119", "1117", "1357", "1118", "1347", "1356", "688", "1593", "1224", "1296", "723", "1658", "1566", "1221", "1689", "1333", "1445", "1297", "1446", "1649", "1218", "1295", "1631", "1217", "1414", "1659", "806", "1220", "732", "1219", "738", "1470", "1323", "1324", "1350", "1956", "1351", "1352", "38", "1416", "246", "1957", "2057", "1821" ], "type": "string", "description": "Select the trade / profession to find leads for.", "default": "2" }, "require_phone_number": { "title": "Require Phone Number", "type": "boolean", "description": "When enabled, only leads that include a phone number are returned.", "default": false } } }, "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 } } }, "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 } } } } } } } } } } ```