Jobs API documentation

Returns consolidated filter data: positions, locations and geography metrics for job search.

curl -sS "https://www.seo-day.de/jobs/api/job-search-filter-data?location=berlin&work_model=remote&sort=date&order=desc"

{
  "success": true,
  "filters": {
    "salary_ranges": [
      { "value": "0-40000", "label": "0 - 40.000 EUR", "count": 0, "count_formatted": "0", "selected": false },
      { "value": "40000-60000", "label": "40.000 - 60.000 EUR", "count": 0, "count_formatted": "0", "selected": false },
      { "value": "60000-80000", "label": "60.000 - 80.000 EUR", "count": 0, "count_formatted": "0", "selected": false },
      { "value": "80000+", "label": "ab 80.000 EUR", "count": 1, "count_formatted": "1", "selected": false }
    ],
    "work_models": [
      { "value": "remote", "count": 1, "count_formatted": "1" }
    ],
    "positions": [
      { "value": "seo-teamlead", "label": "seo teamlead", "count": 1, "count_formatted": "1" }
    ],
    "seniority_levels": [],
    "employment_types": [],
    "remote_percentages": [],
    "skill_tags": [],
    "industries": [
      { "value": "affiliate marketing", "count": 1, "count_formatted": "1" }
    ],
    "company_sizes": [
      { "value": "medium", "count": 1, "count_formatted": "1" }
    ],
    "companies": [
      { "value": "we love x gmbh", "label": "we love x gmbh (1)" }
    ],
    "locations": [
      { "value": "berlin", "label": "berlin (1)" }
    ],
    "selected": {
      "salary_range": null,
      "work_model": "remote",
      "position": null,
      "seniority_level": null,
      "employment_type_normalized": null,
      "remote_percentage_min": null,
      "skill_tag": null,
      "location": "berlin",
      "company": null,
      "industry": null,
      "seo-jobs-only": "",
      "company_size": null,
      "radius": null,
      "sort": "date",
      "order": "desc"
    },
    "seo_jobs_only_counts": {
      "all_formatted": "1",
      "yes_formatted": "1",
      "no_formatted": "0"
    }
  },
  "duration_ms": 707
}

Returns the number of jobs matching the current filter combination.

curl -sS "https://www.seo-day.de/jobs/api/job-search-results-count?location=berlin&work_model=remote&sort=date&order=desc"

{
  "success": true,
  "total_results": 1,
  "total_results_formatted": "1",
  "duration_ms": 948
}

Returns a paginated list of job cards with all fields required by the UI.

curl -sS "https://www.seo-day.de/jobs/api/job-search-results-list?location=berlin&work_model=remote&page=1&sort=date&order=desc"

{
  "success": true,
  "total_results": 1,
  "total_results_formatted": "1",
  "has_more": false,
  "next_url": "",
  "jobs": [
    {
      "id": null,
      "stepstone_id": "13923446",
      "title": "Teamlead SEO - Affiliate Marketing / Content (m/w/d)",
      "company": "We Love X GmbH",
      "company_domain_without_www": null,
      "company_website": null,
      "location": "Berlin",
      "locations": ["Berlin"],
      "created_at": null,
      "position_name": "SEO Teamlead",
      "description_card_display": "Die Rolle ist klar als SEO-Teamlead mit starkem Fokus auf Strategie, Onpage, Offpage, Linkbuilding und Wachstum über Affiliate-Seiten ausgeschrieben. Der SEO-Anteil ist praktisch vollständig und umfasst zusätzlich Teamführung von SEO Content Managern. Remote-Arbeit ist sehr stark betont mit Homeoffice-Setup und Work-from-anywhere-Ansatz. Insgesamt ist es ein SEO-Job auf Teamlead-Niveau.",
      "salary_min_formatted": null,
      "salary_max_formatted": null,
      "estimated_salary_min_formatted": null,
      "estimated_salary_max_formatted": null,
      "is_new": false,
      "seo_relevance_context": "Lead revenue expansion of existing affiliate sites: Develop and implement long-term SEO strategies, optimize high-value pages for rankings and CTR, and own backlink campaigns across multiple affiliate sites.",
      "salary_relevance_context": "Substantial on-page and off-page experience in SEO ... Proven experience managing a team ... Comfortable working in a fast-paced, flat, startup-style environment. Daraus ergibt sich ein Senior-Teamlead-Gehaltsband in Berlin.",
      "remote_work_relevance_context": "Work from anywhere: Our flexible working hours allow you to work by the sea ... Home office setup: We'll set up your home office ... with a balanced mix of in-person meetups and virtual events.",
      "company_logo_path": null,
      "company_logo_base64": "https://www.stepstone.de/upload_DE/logo/9/logoWe-Love-X-GmbH-214981DE.gif"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "start_item_formatted": "1",
    "end_item_formatted": "1",
    "current_page_formatted": "1",
    "total_pages_formatted": "1"
  },
  "duration_ms": 734
}

Autocomplete for locations (cities, states, countries). Suggestions are sorted alphabetically by display name.

curl -sS "https://www.seo-day.de/jobs/api/job-search-location-autosuggest?q=ber&limit=3"

{
  "success": true,
  "suggestions": [
    { "value": "bergheim", "label": "Bergheim" },
    { "value": "berlin", "label": "Berlin" }
  ],
  "duration_ms": 2516
}

Autocomplete for employers and companies. Suggestions are sorted alphabetically by display name.

curl -sS "https://www.seo-day.de/jobs/api/job-search-company-autosuggest?q=seo"

{
  "success": true,
  "suggestions": [
    { "value": "Seokratie GmbH", "label": "Seokratie GmbH" }
  ],
  "duration_ms": 37
}