Häufige Fragen

Für den Katalog ja: 118 von 135 Operationen lehnen einen Aufruf ohne Schlüssel mit 401 ab. Blog, Changelog, Hinweise und geteilte Sammlungen sind offen. Ein kostenloser Explorer-Schlüssel dauert eine Minute. Siehe Authentifizierung.

Beides. Beide tragen denselben Schlüssel auf jedem Endpunkt und keiner wird abgeschafft; die SDKs senden Bearer, die Beispiele hier X-API-Key. Sendest du beide, gewinnt X-API-Key.

Ein 403 heißt, das Credential ist in Ordnung und Plan oder Konto sind nicht berechtigt: Der Endpunkt braucht einen höheren Plan, das Konto ist gesperrt, oder der Schlüssel gehört nicht zu Konto oder Shop, auf das zugegriffen wird. error.reason nennt welches. Ein neuer Schlüssel behebt ein 403 nie. Siehe Fehlerbehandlung.

Nicht mit deinem Schlüssel in der Seite: Jeder kann ihn lesen. Rufe vom Server auf oder über deinen eigenen Proxy, der den Schlüssel anhängt. Der Docs-Playground ist die einzige Ausnahme und behält den Schlüssel nur in deinem Browser.

Nein. Die Seite erreicht die API über einen Proxy mit einem serverseitigen Token, das der Browser nie sieht, hat keinen Plan und keinen Schlüssel und ist pro Besucher limitiert. Siehe Wie wir deine Daten schützen.

Jeder Aufruf, der einen Handler erreicht, auch Fehler. Ein 304 Not Modified zählt nicht gegen die Tagesgrenze, belegt aber einen Minuten-Slot, weshalb sich Conditional Requests lohnen. Siehe Caching.

Pro Minute, pro Tag und pro Monat, jedes für eine andere Frage: Burst, dauerhaftes Scraping und was der Plan verkauft. Minuten- und Tageslimits setzt die API durch und benennt sie im 429; die Monatszahl ist dein Kontingent. Siehe Rate Limits und Pläne.

Plan upgraden, ab $29 im Monat. Enterprise hat individuelle Limits; frag per Support-Ticket. Ein Planwechsel gibt nichts neu aus: Derselbe Schlüssel trägt den neuen Plan sofort.

Sende If-None-Match mit dem erhaltenen ETag; 33 Endpunkte antworten 304, wenn sich nichts geändert hat. Für Mirrors vergleiche das Feld version je Datensatz und abonniere Webhooks statt zu pollen.

Die Zugriffsmatrix beantwortet es pro Endpunkt, die Vergleichstabelle pro Funktion: volle Spezifikationen ab Builder, Kompatibilitäts-Engine und Webhooks ab Studio, der Händlereintrag in Enterprise.

Jeder Datensatz trägt updatedAt und version, von der Datenbank gepflegt, wenn sich eine gelieferte Spalte ändert. Abonniere Webhooks für Pushes oder lies das Changelog für katalogweite Notizen.

dataConfidence sagt, wie vollständig ein Datensatz spezifiziert und wie gut er belegt ist, 0 bis 1; sources listet die Quellseiten. Es ist ein Maß auf Datensatzebene, keine Wahrscheinlichkeit pro Feld. Siehe Feldreferenz.

Caching ist vorgesehen: Cache-Control beachten, mit ETags revalidieren und Webhooks nutzen, um aktuell zu bleiben. Was du weiterverbreiten darfst, regeln die Nutzungsbedingungen, und der Gratisplan ist bewusst so geformt, dass eine Vollkopie nicht möglich ist.

Reiche eine Datenmeldung ein, über die API oder von der Seite des Datensatzes, mit Abschnitt und Quelle. Eine Person prüft sie, und eine akzeptierte Korrektur erreicht jeden Abonnenten. Siehe Feedback und Datenmeldungen.

Null heißt unbekannt oder nicht zutreffend, nie null als Zahl. Ein im Gratisplan fehlendes Feld ist ein bezahltes Feld: Explorer erhält eine Zusammenfassung. Die Feldreferenz markiert, welche Felder ab Builder gelten.

TypeScript und Python, aus derselben OpenAPI-Spezifikation erzeugt wie diese Referenz. Siehe den SDK-Tab und Tools und Spezifikation für Spec-Datei, Postman-Sammlung und Swagger UI.

Ja: llms.txt, Anleitungspakete für Agenten, Tool-Calling-Beispiele und ein MCP-Hinweis stehen unter KI und LLMs, und jede Docs-Seite hat In ChatGPT / Claude / Perplexity öffnen und eine Markdown-Version.

Jede Endpunktseite hat eine Try-It-Konsole: Parameter füllen, mit deinem Schlüssel senden, Antwort als JSON, YAML oder CSV herunterladen und einen Link zur exakten Anfrage teilen. Der Schlüssel bleibt in deinem Browser.