Dates and clock times displayed in the Osintly tools interface and saved-result history are in UTC. API timestamps use their own explicit ISO 8601 offset, typically
Z for UTC.The web application applies lookup volume, cooldown, and concurrency rules to new tool lookups. See Tool usage limits. API-plan capacity is documented separately in API plans & capacity.
IP Intelligence
Investigate IP geolocation, network ownership, routing, services and threat indicators.
Domain Intelligence
Investigate DNS, certificates, registration, infrastructure and public exposure.
Epic Games
Validate and enrich Epic account identifiers, linked accounts, tags,
regions, creator data, friends, and achievements.
Vehicle History Finder
Enrich US VINs and French license plates with vehicle identity, history
signals, recalls, fluids, and capacity data.
Xbox
Enrich Xbox Live gamertags and XUIDs with profile, presence, social, games,
media, clubs, and title details.
Ubisoft
Find Ubisoft Connect accounts from a name, Ubisoft ID, or linked console,
Steam, Discord, or Epic account, with level, games, and Rainbow Six data.
Steam
Enrich Steam vanity names and SteamID64 values with profiles, bans, games,
friends, badges, groups, content, statistics, and inventory.
PlayStation Network
Enrich PSN online IDs and account IDs with profile, presence, trophy summary,
and games.
Roblox
Enrich Roblox usernames and user IDs with profile, social, friends, groups,
games, badges, and collectibles.
Social Club
Enrich Rockstar Social Club nicknames and Rockstar IDs with profile,
linked platforms, crews, friends, and game history.
Enrich Reddit usernames with public profile metadata, archived posts and
comments, communities, activity summaries, and comment threads.
Base URL
- Production:
https://api.osint.ly
Authentication and access
Tools use the same bearer token model as the rest of the Osintly API.tools feature enabled. This applies to every tool route, including routes marked as free. Currently, all Osintly API subscriptions available on osint.ly/api/pricing include access to tools. If the plan does not include tools, the API returns 403 PLAN_FEATURE_REQUIRED.
When to use tools
Response pattern
Most tool responses follow the same envelope:data object changes by operation. Endpoint schemas are documented in the generated Tools Endpoints section.
Caching and provider limits
Tools cache provider answers per collector, so repeating a lookup is faster and does not change route pricing. How long an answer is reused depends on how quickly it can change:
A newly created account can therefore take up to 6 hours to appear, and a renamed account can resolve to its previous name for up to 24 hours. Deleting a search or a saved result stops cached answers for its values from being served.
Identical requests made at the same time receive the same answer.
When a provider is temporarily rate limiting requests, the route answers
429 PROVIDER_RATE_LIMITED with a Retry-After header and a retryAfter field in seconds. Retry after that delay. In /all, a collector that stays rate limited is listed in data.partialErrors with its code and retryAfter while the other sections are returned. This is separate from your own Osintly limits, described in Tool usage limits.
Saving /all results
POST /tools/<tool>/all can synchronously save the returned payload when you add save: true to the request body. This does not change the route cost.
Saved responses include meta.savedResult.id and can be fetched later with:
POST /tools/results/delete with { "ids": ["<result-uuid>"] }. The request accepts 1–100 IDs, is all-or-nothing for inaccessible IDs, and returns 202 with the queued IDs when accepted. Deletion does not re-run enrichment.
Cost discovery
Browse the public Tools Registry at osint.ly/tools to discover currently listed tools and their categories. Every tool exposes acosts endpoint.
defaultPrice and a routes array. Each route entry includes kind, method, quantity, and routePattern.
POST /search is validation-only. It validates and normalizes the submitted identifier without calling the provider or consuming credits. Use /all or the focused enrichment routes when you want provider-backed data.
Next steps
- Review Epic Games
- Review Vehicle History Finder
- Review Xbox
- Review Steam
- Review PlayStation Network
- Review Roblox
- Review Social Club
- Review Reddit
- Review Ubisoft
- Review Tool usage limits
- Explore endpoint schemas in Tools Endpoints