Jobs Autosuggest

Get autocomplete suggestions for job search queries. Returns matching job sectors and locations from Stepstone.

Endpoint

GET /api/stepstone/autosuggest
✨

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Parameters

query string Required

Search input to autocomplete (e.g. "Soft", "Berl")

country string Optional

Country code: de (Germany), at (Austria), nl (Netherlands), be (Belgium). Default: de

limit integer Optional

Max suggestions per type (1–20, default: 10)

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: YOUR_API_KEY_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
<?php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'x-api-key' => 'YOUR_API_KEY_HERE',
])->get('https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10');

return $response->json();
fetch('https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
const axios = require('axios');

axios.get('https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.get('https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10')
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts JSON.parse(response.body)
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10", nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
curl -X GET 'https://scrappa.co/api/stepstone/autosuggest?query=Software&country=de&limit=10' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response Schema

JSON Response 200 OK 
{
    "success": true,
    "data": {
        "suggestions": {
            "sectors": [
                {
                    "id": "1",
                    "label": "Software Development"
                },
                {
                    "id": "2",
                    "label": "Software Engineering"
                }
            ],
            "locations": [
                {
                    "id": "berlin",
                    "label": "Berlin"
                }
            ]
        },
        "metadata": {
            "query": "Software",
            "country": "de",
            "timestamp": "2026-03-20T10:00:00Z"
        }
    }
}

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground
← Back to Home