# Hitta.se Lead Scraper (`odaudlegur/hitta-se-lead-scraper`) Actor Retrieve leads on hitta.se, the easy way. This actor will retrieve the business' name, address, email addresses, phone numbers and social links. - **URL**: https://apify.com/odaudlegur/hitta-se-lead-scraper.md - **Developed by:** [SLASH](https://apify.com/odaudlegur) (community) - **Categories:** Lead generation - **Stats:** 23 total users, 5 monthly users, 100.0% runs succeeded, 3 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Hitta.se Scraper ### Updates in this version - If there is **no website** or it is **banned/unavailable**, keep **all valid detail-page emails** (not only generic). - Email slug fallback now unescapes HTML and matches both: - `-button-email-` - `button-email-` (broader pattern) - Unescape attribute values before extracting emails to handle **entity-encoded** addresses. - Pagination errors fixed ### Kept (still working as intended) - `max_results` with “Nästa” pagination (25 per page). - Website picked from **canonical/og:url/JSON-LD** first, then **scored anchors**; bans junk. - `website_details`: one of **`ok` | `404` | `unavailable` | `banned` | `n/a`**. - **Banned**: `hitta.dixa.help`, `dixa.help`, `biluppgifter.se`, specific DNB URL. - Detail-page email extraction from Hitta UI + mailto + strict regex + slug fallback. - **Same-domain mini-crawl** for emails + social links when website is OK. - Swedish address heuristics; phone extraction; categories. --- ### Features - Crawls **listing pages** on Hitta.se, discovers company **detail pages**, and pushes normalized contact data. - Extracts from detail pages: - `name` - `categories` (best-effort) - `phone` - `address` (Swedish heuristics and JSON-LD) - `website` (structured first, then scored anchors with bans) - `email1..N` (strict parsing, de-duplicated) - `website_details` (status as above) - Socials if available: `social_facebook`, `social_instagram`, `social_linkedin`, `social_x`, `social_youtube`, `social_tiktok`, `social_pinterest` - If website is OK, performs a **tiny same-domain crawl** (configurable) to discover more emails and socials. --- ### Input Configuration Example input JSON: ```json { "start_urls": [ { "url": "https://www.hitta.se/nacka/företag/2" } ], "max_depth": 3, "headers": { "User-Agent": "Mozilla/5.0 ...", "Accept-Language": "sv-SE,sv;q=0.9,en-US;q=0.8,en;q=0.7" }, "timeout_seconds": 30, "site_email_max_pages": 3, "max_results": 0 } ```` | Field | Type | Default | Description | | ---------------------- | ------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------- | | `start_urls` | array | `[{ "url": "https://www.hitta.se/nacka/företag/2"}]` | One or more Hitta listing URLs. | | `max_depth` | integer | `3` | Crawl depth from the start URLs. Listing depth is reused for pagination. | | `headers` | object | See code defaults | HTTP headers for requests. | | `timeout_seconds` | integer | `30` | Read timeout for HTTP requests. | | `site_email_max_pages` | integer | `3` | Max pages to crawl on the **same domain** as the extracted website for extra contacts. | | `max_results` | integer | `0` (no cap) | Limit how many detail results to push. Pagination respects 25/page with “Nästa.” | *** ### How It Works 1. **Listing pages**: extracts detail links using `/verksamhet/` anchors. Follows “Nästa” to paginate. 2. **Detail pages**: extracts: - **Website** from canonical, `og:url`, and JSON-LD; otherwise **scores** external anchors and bans junk domains. - **Address** from JSON-LD, microdata, and Swedish heuristics (street tokens + postcode check). - **Phone** from `tel:` links or strict regex for Swedish formats. - **Emails** from: - Hitta UI attributes (unescaped) - `mailto:` links - Strict regex on visible text - **Slug-pattern fallback**: `-button-email-` and `button-email-` 3. **Website status**: HEAD/GET to classify `website_details` as `ok`, `404`, `unavailable`, `banned`, or `n/a`. 4. **Same-domain mini-crawl** (if website OK): fetch up to `site_email_max_pages` pages for more emails and socials. 5. **Email policy**: - If **no website** or website is **banned/unavailable**, keep **all valid** detail-page emails. - If website is **OK**, keep emails that **match the website base-domain** or are **generic** providers (Gmail, Outlook, etc.). *** ### Example Output ```json { "source_url": "https://www.hitta.se/foeretag/exempel-ab/123456", "name": "Exempel AB", "categories": "Bygg, Renovering", "phone": "08 123 45 67", "address": "Exempelgatan 10, 123 45 Stockholm", "website": "https://www.exempel.se", "email1": "info@exempel.se", "email2": "support@exempel.se", "website_details": "ok", "social_facebook": "https://www.facebook.com/exempel-ab", "social_instagram": "https://www.linkedin.com/exempel-ab", "social_linkedin": "https://www.linkedin.com/company/exempel-ab", "social_x": "https://www.x.com/exempel-ab", "social_youtube": "https://www.youtube.com/exempel-ab", "social_tiktok": "https://www.tiktok.com/exempel-ab", "social_pinterest": "https://www.pinterest.com/exempel-ab" } ``` > If no valid emails are found, the actor emits `"email1": "n/a"`. *** ### Notes - **Pagination:** respects Hitta’s “Nästa” flow, ~25 results per page. - **Bans:** `hitta.dixa.help`, `dixa.help`, `biluppgifter.se`, and a specific DNB marketing URL are excluded. - **Email hygiene:** strict regex, HTML-unescape, de-duplication, and tracking-pattern filtering. - **Address quality:** prefers JSON-LD `PostalAddress`, then microdata, then heuristics requiring Swedish postcode + street token. *** #### Disclaimer & License This Apify Actor is provided **"as is"**, without warranty of any kind — express or implied — including but not limited to the warranties of **merchantability**, **fitness for a particular purpose**, and **non-infringement**. Use it, modify it, break it, or improve it — but **you do so at your own risk**. © 2025 **SLSH**. All rights reserved. Copying or modifying the source code is prohibited. # Actor input Schema ## `start_urls` (type: `array`): Listing pages to start from (e.g. https://www.hitta.se/nacka/företag/2). The scraper will follow detail links from these pages. ## `max_depth` (type: `integer`): Crawl depth for generic link following (kept for compatibility). Listing → detail works regardless. Usually leave as 1. ## `max_results` (type: `integer`): Total businesses to save. Listing pages show up to 25 results each; if this number exceeds 25, the scraper will paginate via the 'Nästa' button until the cap is reached. ## `site_email_max_pages` (type: `integer`): How many pages on the company website to visit for emails and social links. ## `timeout_seconds` (type: `integer`): Read timeout per request. ## Actor input object example ```json { "start_urls": [ { "url": "https://www.hitta.se/nacka/företag/2" } ], "max_depth": 1, "max_results": 0, "site_email_max_pages": 3, "timeout_seconds": 30 } ``` # 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 = { "start_urls": [ { "url": "https://www.hitta.se/nacka/företag/2" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("odaudlegur/hitta-se-lead-scraper").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 = { "start_urls": [{ "url": "https://www.hitta.se/nacka/företag/2" }] } # Run the Actor and wait for it to finish run = client.actor("odaudlegur/hitta-se-lead-scraper").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 '{ "start_urls": [ { "url": "https://www.hitta.se/nacka/företag/2" } ] }' | apify call odaudlegur/hitta-se-lead-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=odaudlegur/hitta-se-lead-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Hitta.se Lead Scraper", "description": "Retrieve leads on hitta.se, the easy way. This actor will retrieve the business' name, address, email addresses, phone numbers and social links.", "version": "1.0", "x-build-id": "C34faEWVqmd9ncJRv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/odaudlegur~hitta-se-lead-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-odaudlegur-hitta-se-lead-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/odaudlegur~hitta-se-lead-scraper/runs": { "post": { "operationId": "runs-sync-odaudlegur-hitta-se-lead-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/odaudlegur~hitta-se-lead-scraper/run-sync": { "post": { "operationId": "run-sync-odaudlegur-hitta-se-lead-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", "required": [ "start_urls" ], "properties": { "start_urls": { "title": "Start URLs", "type": "array", "description": "Listing pages to start from (e.g. https://www.hitta.se/nacka/företag/2). The scraper will follow detail links from these pages.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "max_depth": { "title": "Maximum depth", "minimum": 0, "type": "integer", "description": "Crawl depth for generic link following (kept for compatibility). Listing → detail works regardless. Usually leave as 1.", "default": 1 }, "max_results": { "title": "Maximum number of results", "minimum": 0, "type": "integer", "description": "Total businesses to save. Listing pages show up to 25 results each; if this number exceeds 25, the scraper will paginate via the 'Nästa' button until the cap is reached.", "default": 0 }, "site_email_max_pages": { "title": "Same-domain pages to crawl for contacts", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages on the company website to visit for emails and social links.", "default": 3 }, "timeout_seconds": { "title": "HTTP timeout (seconds)", "minimum": 5, "type": "integer", "description": "Read timeout per request.", "default": 30 } } }, "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 } } } } } } } } } } ```