{
  "openapi": "3.0.1",
  "info": {
    "title": "Eniro.se Company Directory & Contact Finder",
    "description": "Search Sweden's Eniro.se business directory by category and city, or nationwide, and optionally pull each company's rating, hours, website, organization number, and social links.",
    "version": "1.0",
    "x-build-id": "FhQ1acdEgUfCDnzDl"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nimbryxo-studio~eniro-se-company-directory-and-contact-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nimbryxo-studio-eniro-se-company-directory-and-contact-finder",
        "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/nimbryxo-studio~eniro-se-company-directory-and-contact-finder/runs": {
      "post": {
        "operationId": "runs-sync-nimbryxo-studio-eniro-se-company-directory-and-contact-finder",
        "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/nimbryxo-studio~eniro-se-company-directory-and-contact-finder/run-sync": {
      "post": {
        "operationId": "run-sync-nimbryxo-studio-eniro-se-company-directory-and-contact-finder",
        "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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "detail",
              "urls"
            ],
            "type": "string",
            "description": "What to scrape: keyword/category searches, direct company profiles, or a list of Eniro search/profile URLs.",
            "default": "search"
          },
          "query": {
            "title": "Category / keyword",
            "enum": [
              "custom",
              "pizzeria",
              "restaurang",
              "frisör",
              "tandläkare",
              "advokat",
              "elektriker",
              "rörmokare",
              "målare",
              "snickare",
              "bilverkstad",
              "hotell",
              "blomsterhandlare",
              "revisor",
              "fastighetsmäklare",
              "veterinär",
              "optiker",
              "apotek",
              "gym",
              "massage",
              "byggföretag",
              "taxi",
              "flyttfirma",
              "trädgårdsanläggning",
              "försäkringsmäklare",
              "hundfrisör",
              "glasmästare",
              "låssmed",
              "redovisningsbyrå",
              "kafé",
              "bageri"
            ],
            "type": "string",
            "description": "Business category or keyword to search for (mode=search). Pick a common category from the list, or choose 'Custom' and type your own in the field below. Ignored when 'Search terms' is filled.",
            "default": "pizzeria"
          },
          "customQuery": {
            "title": "Custom category/keyword (overrides selection above)",
            "type": "string",
            "description": "Free-text category or keyword not in the curated list above, e.g. 'skorstensfejare' or 'IT-konsult' (mode=search). Takes priority over 'Category / keyword' when set. Use correct Swedish spelling with å/ä/ö -- Eniro's search does not fuzzy-match ASCII-folded keywords."
          },
          "searchTerms": {
            "title": "Search terms (one or more)",
            "type": "array",
            "description": "One or more categories/keywords (mode=search). Every term is combined with every city below, so ['rörmokare', 'elektriker'] x ['Stockholm', 'Göteborg'] covers four searches. Leave empty to use the single 'Category / keyword' selection above.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Swedish city or town to search in, e.g. 'Stockholm', 'Göteborg', 'Malmö' (mode=search). Leave empty to search all of Sweden. Ignored when 'Cities' is filled.",
            "default": "Stockholm"
          },
          "locations": {
            "title": "Cities (one or more)",
            "type": "array",
            "description": "One or more Swedish cities/towns (mode=search), used with every search term. Leave empty to use the single 'City' field above, or to search nationwide when both are empty.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "searchCoordinates": {
            "title": "Search around coordinates (optional)",
            "type": "string",
            "description": "Optional 'latitude,longitude' point for a nearby search, e.g. '57.6346,12.8574' (mode=search). Uses Eniro's own coordinates filter; leave empty for a normal city/nationwide search."
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "relevance",
              "rating",
              "name"
            ],
            "type": "string",
            "description": "How to order the returned results (search modes). Applied after fetching, since Eniro's own listing order is relevance-based.",
            "default": "relevance"
          },
          "ratedOnly": {
            "title": "Only companies with ratings",
            "type": "boolean",
            "description": "Only return companies that have at least one customer rating. Ratings are read from Eniro search cards when present and from the profile page when 'Fetch full company profiles' is enabled.",
            "default": false
          },
          "minRating": {
            "title": "Minimum rating",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "5"
            ],
            "type": "string",
            "description": "Only return companies rated at least this many stars, e.g. '4' for 4.0+ (search modes). Unrated companies are excluded when a minimum is set.",
            "default": ""
          },
          "hasWebsiteOnly": {
            "title": "Only companies with a website",
            "type": "boolean",
            "description": "Only return companies that list a website (search modes). Websites appear on profile pages, so enable 'Fetch full company profiles' for this filter to find any matches.",
            "default": false
          },
          "hasPhoneOnly": {
            "title": "Only companies with a phone number",
            "type": "boolean",
            "description": "Only return companies that publish at least one phone number (search modes).",
            "default": false
          },
          "hasEmailOnly": {
            "title": "Only companies with an email",
            "type": "boolean",
            "description": "Only return companies that publish an email address (search modes). Emails appear on profile pages, so enable 'Fetch full company profiles' for this filter to find any matches.",
            "default": false
          },
          "includeSoleTraders": {
            "title": "Include sole traders",
            "type": "boolean",
            "description": "Keep one-person firms that Eniro lists under the owner's personal name (e.g. 'Anders Svensson'). Turn this off for company-only lead lists; names carrying a company suffix (AB, HB, KB, förening) are always kept.",
            "default": true
          },
          "fetchDetails": {
            "title": "Fetch full company profiles",
            "type": "boolean",
            "description": "For each search result, also visit its company profile page to collect multiple phone numbers, email, rating counts, all opening-hours groups, category codes, promotional links, cover photo, coordinates, description, images and organization number. Slower, but far richer output (search modes).",
            "default": false
          },
          "businessUrls": {
            "title": "Company profile URLs or IDs (mode=detail)",
            "type": "array",
            "description": "Direct Eniro company URLs (e.g. https://www.eniro.se/<name>/<id>/firma) or bare numeric company IDs to fetch, one per line. Use the 'sourceUrl' or 'businessId' field from search results.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "startUrls": {
            "title": "Eniro search or profile URLs (mode=urls)",
            "type": "array",
            "description": "Eniro search URLs (e.g. https://www.eniro.se/rörmokare+stockholm/företag) and/or company profile URLs (e.g. https://www.eniro.se/<name>/<id>/firma). Search URLs paginate automatically; profile URLs are fetched directly.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Stop each search term/city after this many result pages (25 companies per page). Keeps large categories bounded.",
            "default": 20
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Hard cap on the number of company records to return across all terms, cities and URLs.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}