{ "openapi": "3.0.1", "info": { "title": "Public Reference Finder — TruthFinder Alternative", "description": "Find public-reference candidates for authorized name-and-location research. Export source URLs, collection times, and route outcomes in a privacy-scoped report for source review and follow-up research.", "version": "0.1", "x-build-id": "ql0NMiI4hmKmbgR4u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~truthfinder-alternative/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-truthfinder-alternative", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~truthfinder-alternative/runs": { "post": { "operationId": "runs-sync-khadinakbar-truthfinder-alternative", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~truthfinder-alternative/run-sync": { "post": { "operationId": "run-sync-khadinakbar-truthfinder-alternative", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries", "authorizedUseConfirmed" ], "properties": { "queries": { "title": "Consented name-and-location queries", "minItems": 1, "maxItems": 3, "uniqueItems": true, "type": "array", "description": "Provide one to three broad identity queries you are authorized to research, such as [{\"fullName\":\"Ada Lovelace\",\"locationHint\":\"London, UK\"}]. Each query accepts a name and an optional broad city, state, region, or country. The default contains one stable public-figure example and every completed query creates one billable source report. Do not submit an email address, phone number, street address, postal code, URL, birth date, or credential.", "items": { "type": "object", "properties": { "fullName": { "title": "Full name", "type": "string", "description": "Enter a broad person name such as Ada Lovelace or Malala Yousafzai. Names must be 2 to 120 characters and may contain letters, spaces, apostrophes, periods, or hyphens. This field is used only to query public reference indexes and is not repeated in output records. It is not an email, phone number, address, postal code, URL, or date of birth.", "editor": "textfield", "example": "Ada Lovelace", "minLength": 2, "maxLength": 120 }, "locationHint": { "title": "Broad location hint", "type": "string", "description": "Optionally add a broad city, state, region, or country to disambiguate a public reference search, for example London, UK. Leave it blank when a name alone is sufficient; it never needs a house number or postal code. The Actor rejects precise addresses, phone numbers, emails, URLs, and postal codes. This is a broad search qualifier, not a location-tracking input.", "editor": "textfield", "example": "London, UK", "maxLength": 80 } }, "required": [ "fullName" ] } }, "authorizedUseConfirmed": { "title": "Confirm authorized, non-screening use", "type": "boolean", "description": "Set this to true only when you are searching your own information, a subject who has consented, or a lawful public-interest research subject. It defaults to false so unauthorized queries stop with a clear INVALID_INPUT outcome. The Actor is never for employment, tenant, credit, insurance, law-enforcement, eligibility, or other FCRA-regulated decisions. This is an attestation, not identity verification.", "default": false }, "purpose": { "title": "Authorized research purpose", "enum": [ "self_lookup", "consented_research", "public_interest_research" ], "type": "string", "description": "State the allowed context for this source-search request: self_lookup, consented_research, or public_interest_research. It defaults to self_lookup and is recorded in the result so downstream users can preserve the declared boundary. Choose consented_research only with the subject's permission. This enum does not permit employment, housing, credit, insurance, or eligibility screening.", "default": "self_lookup" }, "maxResultsPerQuery": { "title": "Maximum source matches per query", "minimum": 1, "maximum": 10, "type": "integer", "description": "Cap the public source matches retained for each query after results are interleaved across Wikidata and Wikipedia. Choose a value from 1 to 10; the default is 5 for a compact, agent-readable report. Smaller values reduce response size while still checking both source routes. This is a result-display cap, not a promise that an identity match exists.", "default": 5 }, "responseFormat": { "title": "Response detail", "enum": [ "concise", "detailed" ], "type": "string", "description": "Choose concise for titles and source links only, or detailed to include short source-provided descriptions and search snippets. It defaults to concise to minimize personal-data exposure in the dataset. Both modes keep the same source URL, collection time, and outcome contract. This is not a request to fetch full article content or bypass a source access control.", "default": "concise" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }