Test data states
Exercise success, private, not-found, sparse, empty, null, and paginated behavior with documented inputs.
Test behavior comes from the input, just as it does in Live. There is no scenario header or test-only parameter.
Instagram profile examples
| Input | Expected result | Traits |
|---|---|---|
northstar_forge_test | 200 | Public, rich, verified, posts, pagination |
stillwater_archive_test | 200 | Sparse, unavailable metrics |
empty_cabin_test | 200 | Empty post collection, real zero values |
quiet_harbor_test | 403 PROFILE_PRIVATE | Private |
closed_lighthouse_test | 404 PROFILE_NOT_FOUND | Deleted |
missing_openhandle_test | 404 PROFILE_NOT_FOUND | Documented unknown value |
For example, test private-profile handling with a normal request:
curl "https://api.openhandle.dev/v1/instagram/profiles/@quiet_harbor_test" \
-H "Authorization: Bearer $OPENHANDLE_TEST_KEY"Private and not-found answers are definitive test answers. They create a test
usage entry with a $0.000 actual charge. Authentication, validation, rate-limit,
service, and internal failures create request history only.
Unknown and malformed values
A valid identifier that is not in the synthetic dataset returns the normal not-found error. A malformed identifier returns the normal validation error. These are different cases; use a documented unknown value when you need a stable not-found test.
Null, zero, empty, and omitted
nullmeans the source value is unavailable. It does not mean zero.0is a known numeric zero.[]is a known empty collection.- An omitted optional field is not part of that platform or response form.
Pagination
Use a catalog record with the paginated trait. Pass the returned opaque
meta.cursors.next value unchanged. The dataset has stable ordering, no duplicate
items, and a deterministic terminal page. A cursor from another dataset version,
operation, or query returns the normal cursor error.
Use the catalog filters for TikTok records and for posts, comments, and replies. The catalog is authoritative; this page shows only a short starting set.