Build against Node Data
These pages cover the SDK and the integration patterns that come up in real work. The canonical, product-level API reference lives on nodedata.ai/docs — when the two disagree, that one wins.
Three things to know first
https://www.nodedata.ai/api/v1. Authentication is Authorization: Bearer nd_live_…. Every error body is { error: { code, message } } with a stable code you can branch on.Start here
Quickstart
From zero to a verified API call in about a minute, with or without the SDK.
Authentication
Key format, modes, scopes, and how to avoid the mistakes that leak credentials.
Errors & retries
Every error code, which are retryable, and how backoff should behave.
Pagination
Cursor pagination, why it beats offsets, and how to resume a partial walk.
Webhooks
Signature verification, replay protection, idempotency, and the event catalog.
Inference
The OpenAI-compatible endpoint, streaming, model catalog, and cost control.
The shortest possible example
curl https://www.nodedata.ai/api/v1/me \ -H "Authorization: Bearer $NODE_DATA_API_KEY"A 200 confirms the key works and tells you which scopes it carries. A 401 means the key is missing, malformed, or revoked; a 402 means it's a premium key that hasn't completed activation.
Conventions used across the API
- Money is integer cents.
price.amountof4900is $49.00. Divide only when displaying. - Timestamps are ISO 8601 strings in UTC, on fields suffixed
_at. - Collections are enveloped as
{ items, next_cursor, has_more }so the shape can grow without breaking clients. - Field names are snake_case on the wire, and the SDK keeps them that way rather than hiding a mapping layer.
- Scopes are fixed at key creation. A key cannot widen its own permissions.
Where things live
| What | Where |
|---|---|
| Create and revoke API keys | nodedata.ai/dashboard/api-keys |
| Canonical API reference | nodedata.ai/docs/api-reference |
| Product docs, licensing, revenue | nodedata.ai/docs |
| SDK source and reference | nodedata.dev/sdk |
| Interactive tools | nodedata.dev/tools |