Quickstart

Create a Test API key, then call a profile endpoint with a documented synthetic handle. The request uses the complete API pipeline and has a $0.000 actual charge. No email verification, payment method, or free Live request is required.

1. Create an API key

Sign in at app.openhandle.dev, open API Keys, and create a Test key. The full oh_test_ secret is shown once, so store it as OPENHANDLE_TEST_KEY in your secret manager.

2. Make a request

curl "https://api.openhandle.dev/v1/instagram/profiles/@northstar_forge_test" \
  -H "Authorization: Bearer $OPENHANDLE_TEST_KEY"

Every API-reference page has the same cURL, TypeScript, and Go switcher for its Test request.

3. Verify Test metadata

The response headers include Openhandle-Environment: test, Openhandle-Cost: 0.000, the live-equivalent Openhandle-List-Price, and an Openhandle-Dataset-Version. The body uses the same schema as Live.

Every response uses the same data and meta envelope. List responses add meta.cursors.next for pagination. Metrics that the platform does not expose are null, never 0.

Next steps

• Find another success or error in the Test Data catalog.
• Fetch posts: /v1/instagram/profiles/@northstar_forge_test/posts.
• Control cost with the freshness parameter. See freshness and caching.
• Explore every operation interactively in the dashboard playground.
• When ready, move from Test to Live.