> ## Documentation Index > Fetch the complete documentation index at: https://docs.osint.ly/llms.txt > Use this file to discover all available pages before exploring further. # Start a saved Reddit lookup with browsing included > Costs 1 core_search unit. Collects only the profile, always saves it (even if save:false), and returns data.profile and meta.savedResult.id. No polling. Subsequent /browse calls with that ID are free. Default page size is 25. Reuse the saved ID rather than calling lookup again on refresh. ## OpenAPI ````yaml /tools-reference/openapi.json post /tools/reddit/lookup openapi: 3.1.0 info: title: Osintly Tools API version: 1.0.0 description: >- OpenAPI specification for Osintly Epic Games, Vehicle History Finder, Xbox, PlayStation Network, Roblox, Steam, Social Club, and Reddit tools and catalog endpoints. contact: name: Osintly url: https://docs.osint.ly/tools-reference/introduction servers: - url: https://api.osint.ly description: Production security: - bearerAuth: [] tags: - name: Tools Catalog description: Discover available tools, metadata, and route costs. - name: Epic Games description: Direct Epic Games account validation and enrichment endpoints. - name: Vehicle History Finder description: >- Vehicle history enrichment endpoints for US VINs and French license plates. - name: Xbox description: Direct Xbox Live account validation and enrichment endpoints. - name: PlayStation Network description: Direct PlayStation Network account validation and enrichment endpoints. - name: Roblox description: Direct Roblox account validation and enrichment endpoints. - name: Steam description: Direct Steam account validation and enrichment endpoints. - name: Social Club description: Direct Rockstar Social Club account validation and enrichment endpoints. - name: Reddit description: >- Reddit profile and public archived activity validation and enrichment endpoints. paths: /tools/reddit/lookup: post: tags: - Reddit summary: Start a saved Reddit lookup with browsing included description: >- Costs 1 core_search unit. Collects only the profile, always saves it (even if save:false), and returns data.profile and meta.savedResult.id. No polling. Subsequent /browse calls with that ID are free. Default page size is 25. Reuse the saved ID rather than calling lookup again on refresh. operationId: runRedditLookup requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RedditLookupRequest' example: value: spez type: username responses: '200': $ref: '#/components/responses/RedditToolResponse' '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/PlanFeatureRequired' '404': $ref: '#/components/responses/NotFound' '429': description: Insufficient quota (RATE_LIMIT_EXCEEDED) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '502': $ref: '#/components/responses/ProviderError' '503': description: Result could not be saved or quota could not be checked content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '504': $ref: '#/components/responses/ProviderTimeout' components: schemas: RedditLookupRequest: allOf: - $ref: '#/components/schemas/RedditRequest' - properties: limit: type: integer minimum: 1 maximum: 100 default: 25 ErrorResponse: type: object required: - error - meta properties: error: type: object required: - code - message properties: code: type: string message: type: string details: {} additionalProperties: true meta: $ref: '#/components/schemas/ResponseMeta' additionalProperties: false RedditRequest: type: object required: - value - type properties: value: type: string minLength: 3 maxLength: 256 description: Reddit username, u/, @, or Reddit profile URL. example: spez type: type: string description: Canonical Reddit search type or accepted alias. enum: - username - pseudonym - reddit - u - user example: username after: oneOf: - type: string - type: number description: ISO date or Unix timestamp lower bound. before: oneOf: - type: string - type: number description: ISO date or Unix timestamp upper bound or pagination cursor. deletedOnly: type: boolean default: false keywords: type: string maxLength: 200 limit: type: integer minimum: 1 maximum: 100 default: 100 nsfwOnly: type: boolean default: false sort: type: string enum: - asc - desc - score default: desc subreddit: type: string maxLength: 64 save: type: boolean description: >- Used on /all and /profile to save the synchronous response. /lookup always saves, regardless of this flag. default: false resultId: type: string format: uuid description: >- For /feed: existing owned saved profile ID to complete under the same ID. additionalProperties: false RedditToolResponse: type: object required: - data - meta - operation - query - tool properties: data: type: object additionalProperties: true meta: $ref: '#/components/schemas/ResponseMeta' operation: type: string query: type: object required: - value - type properties: value: type: string type: type: string normalizedType: type: string additionalProperties: true tool: type: string const: reddit additionalProperties: false ResponseMeta: type: object required: - timestamp properties: timestamp: type: string format: date-time savedResult: $ref: '#/components/schemas/SavedToolResult' additionalProperties: true SavedToolResult: type: object required: - id - url properties: id: type: string format: uuid url: type: string format: uri additionalProperties: false responses: RedditToolResponse: description: Structured Reddit tool response. Enriched data varies by operation. content: application/json: schema: $ref: '#/components/schemas/RedditToolResponse' example: tool: reddit operation: search query: value: spez type: username normalizedType: username data: valid: true status: validated meta: timestamp: '2026-09-09T00:00:00.000Z' ValidationError: description: Invalid request body or parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: VALIDATION_ERROR message: Invalid request body details: - path: value message: Invalid value meta: timestamp: '2026-06-28T12:00:00.000Z' Unauthorized: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UNAUTHORIZED message: Unauthorized details: A valid API key is required meta: timestamp: '2026-06-28T12:00:00.000Z' PlanFeatureRequired: description: >- The authenticated account does not have a paid API subscription with tools access content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: PLAN_FEATURE_REQUIRED message: Plan feature required details: >- Tools require a paid API subscription with the tools feature enabled meta: timestamp: '2026-06-28T12:00:00.000Z' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: NOT_FOUND message: Not found meta: timestamp: '2026-06-28T12:00:00.000Z' ProviderError: description: An upstream Reddit provider request failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: PROVIDER_ERROR message: Data unavailable meta: timestamp: '2026-06-28T12:00:00.000Z' ProviderTimeout: description: An upstream Reddit provider request timed out content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: PROVIDER_TIMEOUT message: Request timed out meta: timestamp: '2026-06-28T12:00:00.000Z' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key ````