Finn.no Job Scraper

A powerful Apify actor that scrapes job listings from Finn.no, Norway's largest job board. Extract detailed job information including company details, contact information, job descriptions, and more.

🚀 Features

• Comprehensive Job Data: Scrapes job title, company, location, deadline, contact details, and full descriptions
• Advanced Filtering: Filter by industry, employment type, job duration, and location
• Smart Extraction: Uses intelligent text parsing to extract structured data from job pages
• Rate Limiting: Built-in delays and retry logic to avoid blocking
• Flexible Output: Clean, structured JSON output ready for analysis
• Recent Jobs Focus: Option to scrape only jobs posted in the last 24 hours

📊 Extracted Data

Each job listing includes the following fields:

{
  "company": "Equinor ASA",
  "title": "Senior Software Developer",
  "location": "0473 Oslo",
  "deadline": "15.12.2024",
  "contactPerson": "John Doe",
  "contactPosition": "HR Manager", 
  "contactPhone": "+47 123 45 678",
  "workLanguage": "Norsk/Engelsk",
  "description": "Full job description text...",
  "fullJobLink": "https://www.finn.no/job/fulltime/ad.html?finnkode=123456789",
  "scrapedAt": "2024-08-27T10:30:00.000Z"
}

⚙️ Input Configuration

Basic Settings

Field	Type	Description	Default
Search Query	String	Job search keywords (e.g., "javascript developer", "marketing manager")	""
Location	String	Location filter (e.g., "Oslo", "Bergen", "Stavanger")	""
Maximum Pages	Number	Maximum number of pages to scrape (each page ~20 jobs)	10
Maximum Jobs	Number	Maximum total jobs to scrape	200
Only New Jobs	Boolean	Only scrape jobs posted in the last 24 hours	true
Include Job Description	Boolean	Scrape full job description text (slower but more detailed)	true

Advanced Filters

Industry Filters

Select from available industry options in the dropdown menu. The actor will automatically use the correct industry IDs:

Display Name	Industry ID	Norwegian Name
Construction	4	Bygg og anlegg
Oil and Gas	46	Olje og gass
Consultant	34	Konsulent og rådgivning
Maritime and Offshore	69	Maritim og offshore
Ops and Maint	17	Drift og vedlikeholdstjenester
Def and Military	23	Forsvar og militær
Manufacturing	70	Produksjon
Energy	35	Kraft og energi
Shipping	55	Transport og logistikk
Construction Industry	62	Industri og produksjon

Employment Type

Display Name	Type ID	URL Parameter
Full-time	3947	extent=3947

Job Duration

Display Name	Duration ID	URL Parameter
Fixed	3951	job_duration=3951
Contract	3952	job_duration=3952
Agency	8901	job_duration=8901
Project	8099	job_duration=8099

🏃‍♂️ Usage Examples

Basic Job Search

{
  "searchQuery": "python developer",
  "location": "Oslo", 
  "maxPages": 5,
  "maxJobs": 100,
  "industry": ["34", "46"]
}

Oil & Gas Industry Focus

{
  "searchQuery": "engineer",
  "industry": ["46", "69"],
  "location": "Stavanger",
  "onlyNewJobs": true,
  "maxJobs": 150
}

IT Consultant Positions

{
  "searchQuery": "consultant",
  "industry": ["34"],
  "employmentType": ["3947"], 
  "duration": ["3952"],
  "includeJobDescription": true
}

🔧 API Usage

With Apify Client (JavaScript)

import { ApifyApi } from 'apify-client';

const client = new ApifyApi({
    token: 'YOUR_API_TOKEN',
});

const input = {
    searchQuery: "data scientist",
    location: "Oslo",
    industry: ["34", "46"],
    maxJobs: 50
};

const run = await client.actor('YOUR_ACTOR_ID').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

With n8n

1. Add an Apify node to your workflow
2. Configure the actor ID and input parameters
3. Process the returned job data in subsequent nodes

With cURL

curl -X POST https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "searchQuery": "marketing manager",
    "location": "Bergen", 
    "maxJobs": 75,
    "industry": ["3", "34"]
  }'

📈 Performance & Limitations

Performance Tips

• Limit job descriptions: Set includeJobDescription: false for faster scraping
• Use specific filters: Industry and location filters reduce processing time
• Reasonable limits: Keep maxJobs under 500 for optimal performance
• Recent jobs: Enable onlyNewJobs for faster, more relevant results

Rate Limiting

• Built-in delays between requests (2-3 seconds)
• Automatic retry logic for failed requests
• Cookie consent handling
• Respectful crawling practices

Limitations

• Norwegian language: Job descriptions are primarily in Norwegian
• Dynamic content: Some job details may require JavaScript rendering
• Rate limits: Finn.no may block excessive requests
• Data accuracy: Extracted data depends on consistent page structure

🛠️ Troubleshooting

Common Issues

"No jobs found"

• Check if your search query and filters are too restrictive
• Verify location spelling (use Norwegian names)
• Try broader search terms

"Incomplete job data"

• Some jobs may have limited information available
• Contact details are not always public
• Enable includeJobDescription for more complete data

"Actor timeout"

• Reduce maxJobs or maxPages
• Disable job descriptions for faster processing
• Use more specific search filters

Error Messages

• "Invalid industry ID": Use industry IDs from the supported list above
• "Page not found": Location or search parameters may be invalid
• "Request timeout": Try reducing the scope of your search

🔄 Updates & Changelog

Current Version

• Comprehensive input validation and error handling
• Expanded industry filter options
• Improved contact information extraction
• Enhanced schema compatibility
• Added support for discovering custom filter IDs

📝 Output Format

Results are saved to the default dataset in JSON format. Each job is a separate item with all available fields populated. Missing information is marked as "N/A".

Sample Output

[
  {
    "company": "Telenor ASA",
    "title": "Senior Data Engineer",
    "location": "1366 Lysaker",
    "deadline": "20.12.2024",
    "contactPerson": "Anna Hansen",
    "contactPosition": "Technical Recruiter",
    "contactPhone": "+47 900 12 345",
    "workLanguage": "Engelsk",
    "description": "We are looking for a Senior Data Engineer to join our Analytics team...",
    "fullJobLink": "https://www.finn.no/job/fulltime/ad.html?finnkode=987654321",
    "scrapedAt": "2024-08-27T14:22:33.000Z"
  }
]

📞 Support

For issues, feature requests, or questions about this actor:

• Check the Apify documentation
• Review common troubleshooting steps above
• Contact support through the Apify Console

📄 Legal & Ethics

This actor is designed for legitimate business use cases such as:

• Job market research and analysis
• Recruitment and talent acquisition
• Market intelligence and competitor analysis

Please ensure your use complies with:

• Finn.no's terms of service
• Norwegian data protection laws (GDPR)
• Respectful crawling practices

Note: This actor is not affiliated with or endorsed by Finn.no. Use responsibly and in accordance with applicable laws and terms of service.