Operations
Versioning
Paths are platform-scoped under/v1/instagram/. Within v1, evolution is additive only. New fields, new registry IDs, and new endpoints may appear. Existing fields never change meaning. A material semantic change creates a new field or a new major version.
Ignore unknown response fields. Preserve unknown classification IDs.
Identifiers
Klint IDs are opaque, durable, and prefixed by resource family:ig_post_…, ig_account_…, ig_media_…, ig_audio_…. They are the only durable keys. Instagram handles and shortcodes are reconciliation aliases that can change.
Request identity
Every search response carriesrequest_id in its envelope. Entity GETs return the bare resource, so their request identity travels as a response header. The OpenAPI contract fixes the header name. Error responses carry the same request_id in the problem object. Quote it when you report an issue.
We hand-author these pages against the accepted contract. At contract freeze they migrate to OpenAPI-generated pages, and the prose stays. Items marked open may change until then.