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 payment method or free Live request is required. You only verify your email with the code we send at signup.

1. Create a free account and a Test key

Create a free account. You get 100 free requests, and no card is needed. If you already have an account, sign in.

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.