Ocean.ioPersonendatenEnrichment

Autocomplete a location

oceanio.people.autocomplete.locations

Auto complete the location search

Price: $0.0081/callZum Listenpreis
Success rate: —Noch keine ErfolgsratendatenNoch keine Erfolgsratendaten
Latency p50: ——
Last verified: 20.08.2026Verified working

POSThttps://toolswitch.dev/v1/tools/oceanio.people.autocomplete.locationsBeta

Uses platform quota
Synchronous response
Reads public data

Parameter

returns filterCode alongside the name — filterCode is the value the search filters want, not the display name. Place names are ambiguous (San Francisco exists in the US, Nicaragua, Panama and Argentina), so resolving through here is what stops a search silently targeting the wrong country

Parameter	Typ	Erforderlich	Beschreibung	Beispiel
Anfragetext (JSON)
`limit`	Ganzzahl	Optional	how many suggestions, default 5, max 15	`5`
`query`	Zeichenkette	Erforderlich	the beginning of a place name	`San Fra`
`locationType`	Zeichenkette	Optional	narrow to one level of the hierarchy (country / state / city …)

Anfragetext (JSON)
limitGanzzahlOptional
how many suggestions, default 5, max 15
Beispiel: 5
queryZeichenketteErforderlich
the beginning of a place name
Beispiel: San Fra
locationTypeZeichenketteOptional
narrow to one level of the hierarchy (country / state / city …)

Codebeispiele

Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.

Beta

curl -X POST 'https://toolswitch.dev/v1/tools/oceanio.people.autocomplete.locations' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"limit":5,"query":"San Fra"}'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/oceanio.people.autocomplete.locations",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("{\"limit\":5,\"query\":\"San Fra\"}"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/oceanio.people.autocomplete.locations", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("{\"limit\":5,\"query\":\"San Fra\"}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

Diese Gateway-API ist in der Beta; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit $0.0081/call einschließlich Servicegebühr abgerechnet.