Crawdar Business Research

{'type': 'object', 'required': ['id', 'jobToken'], 'properties': {'id': {'type': 'string', 'maxLength': 36, 'minLength': 36, 'description': 'Queued or running job id.'}, 'jobToken': {'type': 'string', 'maxLength': 100, 'minLength': 20, 'description': 'Private token belonging to the job.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string'}, 'status': {'enum': ['canceled']}, 'canceledAt': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['resultLanes', 'guidance', 'interfaces'], 'properties': {'guidance': {'type': 'array', 'items': {'type': 'string'}}, 'interfaces': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'resultLanes': {'type': 'object', 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'jobToken'], 'properties': {'id': {'type': 'string', 'maxLength': 36, 'minLength': 36, 'description': 'Job id returned by start_lead_search, refine_lead_search, or retry_lead_search.'}, 'view': {'enum': ['compact', 'full'], 'default': 'compact', 'description': 'Compact minimizes tokens. Full retains detailed evidence fields.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum prospects in this result page.'}, 'cursor': {'type': 'string', 'description': 'Opaque nextCursor from the previous response.'}, 'jobToken': {'type': 'string', 'maxLength': 100, 'minLength': 20, 'description': 'Private token returned with the job. Do not log or share it.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string'}, 'error': {'type': 'string'}, 'status': {'enum': ['queued', 'running', 'completed', 'failed', 'canceled']}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'prospectStatus', 'whyMatch', 'criteria', 'contactRoute'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'website': {'type': 'string'}, 'criteria': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': True}}, 'whyMatch': {'type': 'array', 'items': {'type': 'string'}}, 'fitStatus': {'enum': ['verified', 'likely']}, 'confidence': {'type': 'number'}, 'sourceUrls': {'type': 'array', 'items': {'type': 'string'}}, 'websiteUrl': {'type': 'string'}, 'contactRoute': {'type': 'object', 'additionalProperties': True}, 'prospectStatus': {'enum': ['qualified', 'possible']}, 'evidenceQuality': {'enum': ['strong', 'moderate', 'weak']}, 'entityConfidence': {'type': 'number'}, 'qualificationChecks': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'qualificationConfidence': {'type': 'number'}}, 'additionalProperties': True}}, 'progress': {'type': 'object', 'additionalProperties': True}, 'returned': {'type': 'integer'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'createdAt': {'type': 'string'}, 'errorCode': {'type': 'string'}, 'nextCursor': {'type': ['string', 'null']}, 'retryAfter': {'type': 'integer'}, 'completedAt': {'type': ['string', 'null']}, 'diagnostics': {'type': 'object', 'additionalProperties': True}, 'resultCount': {'type': 'integer'}, 'searchedSources': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}

{'type': 'object', 'required': ['id', 'jobToken'], 'properties': {'id': {'type': 'string', 'maxLength': 36, 'minLength': 36, 'description': 'Completed source job id returned by an earlier durable search call.'}, 'brief': {'type': 'string', 'maxLength': 500, 'minLength': 8, 'description': 'Replacement natural-language brief for the new job.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum prospects retained by the new job.'}, 'fields': {'type': 'array', 'items': {'enum': ['Website', 'Business email', 'Phone', 'Location', 'Owner type', 'Description', 'Source links']}, 'description': 'Business fields to retain. Website and source evidence remain available for verification.'}, 'target': {'type': 'string', 'maxLength': 220, 'minLength': 3, 'description': 'Replacement business target for the new job.'}, 'jobToken': {'type': 'string', 'maxLength': 100, 'minLength': 20, 'description': 'Private token belonging to the source job.'}, 'geography': {'type': 'string', 'maxLength': 140, 'minLength': 2, 'description': 'Replacement city, region, country, or Worldwide.'}, 'qualifier': {'type': 'string', 'maxLength': 900, 'description': 'Replacement public requirements and exclusions.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'status', 'statusUrl', 'exportUrl', 'retryUrl', 'cancelUrl', 'expiresInSeconds'], 'properties': {'id': {'type': 'string', 'description': 'Stable job identifier. Use it with jobToken in every lifecycle call.'}, 'status': {'enum': ['queued', 'running', 'completed', 'failed', 'canceled'], 'description': 'Current durable job state.'}, 'cacheHit': {'type': 'boolean'}, 'jobToken': {'type': 'string', 'description': 'Private bearer token required to read, refine, or export this job.'}, 'retryUrl': {'type': 'string', 'description': 'Authenticated REST URL for creating a replacement after retryable failure.'}, 'cancelUrl': {'type': 'string', 'description': 'Authenticated REST URL for canceling queued or running work.'}, 'exportUrl': {'type': 'string', 'description': 'Authenticated CSV export URL. Add format=json for JSON.'}, 'statusUrl': {'type': 'string', 'description': 'Authenticated REST URL for job status and result pages.'}, 'resultCount': {'type': 'integer'}, 'expiresInSeconds': {'type': 'integer', 'description': 'Seconds until the private job and token expire.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['brief'], 'properties': {'brief': {'type': 'string', 'maxLength': 1200, 'minLength': 8, 'description': 'Example: Independent veterinary clinics in Berlin with an active first-party website. Exclude directories and chains.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum businesses in this response page.'}, 'fields': {'type': 'array', 'items': {'enum': ['Website', 'Business email', 'Phone', 'Location', 'Owner type', 'Description', 'Source links']}, 'description': 'Business fields to retain. Website and source evidence remain available for verification.'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Zero-based result offset for this response page.'}, 'output': {'enum': ['compact', 'full'], 'default': 'compact', 'description': 'Compact minimizes tokens. Full preserves every returned field.'}, 'geography': {'type': 'string', 'maxLength': 140, 'minLength': 2, 'description': 'Optional explicit geography. Use when the brief does not make location clear.'}, 'includeDiagnostics': {'type': 'boolean', 'default': True, 'description': 'Include source status and explained exclusions.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['schemaVersion', 'requestId', 'resultCount', 'returnedCount', 'offset', 'limit', 'hasMore', 'results', 'searchedSources', 'warnings'], 'properties': {'limit': {'type': 'integer', 'description': 'Maximum prospects requested for this page.'}, 'offset': {'type': 'integer', 'description': 'Zero-based offset of this page.'}, 'hasMore': {'type': 'boolean', 'description': 'Whether another result page is available.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'prospectStatus', 'whyMatch', 'criteria', 'contactRoute'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'website': {'type': 'string'}, 'criteria': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': True}}, 'whyMatch': {'type': 'array', 'items': {'type': 'string'}}, 'fitStatus': {'enum': ['verified', 'likely']}, 'confidence': {'type': 'number'}, 'sourceUrls': {'type': 'array', 'items': {'type': 'string'}}, 'websiteUrl': {'type': 'string'}, 'contactRoute': {'type': 'object', 'additionalProperties': True}, 'prospectStatus': {'enum': ['qualified', 'possible']}, 'evidenceQuality': {'enum': ['strong', 'moderate', 'weak']}, 'entityConfidence': {'type': 'number'}, 'qualificationChecks': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'qualificationConfidence': {'type': 'number'}}, 'additionalProperties': True}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Limitations the agent should retain with downstream data.'}, 'requestId': {'type': 'string', 'description': 'Request identifier for support and diagnostics.'}, 'durationMs': {'type': 'integer'}, 'nextOffset': {'type': ['integer', 'null'], 'description': 'Offset for the next synchronous result page, or null when complete.'}, 'diagnostics': {'type': 'object', 'description': 'Source status and explained candidate exclusions.', 'additionalProperties': True}, 'resultCount': {'type': 'integer', 'description': 'Total accepted prospects before response pagination.'}, 'returnedCount': {'type': 'integer', 'description': 'Prospects returned in this response page.'}, 'schemaVersion': {'type': 'string', 'description': 'Version of the result contract.'}, 'searchedSources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Discovery and first-party source types consulted.'}, 'remainingFreeSearches': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['id', 'jobToken'], 'properties': {'id': {'type': 'string', 'maxLength': 36, 'minLength': 36, 'description': 'Failed or timed-out source job id.'}, 'jobToken': {'type': 'string', 'maxLength': 100, 'minLength': 20, 'description': 'Private token belonging to the source job.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'status', 'statusUrl', 'exportUrl', 'retryUrl', 'cancelUrl', 'expiresInSeconds'], 'properties': {'id': {'type': 'string', 'description': 'Stable job identifier. Use it with jobToken in every lifecycle call.'}, 'status': {'enum': ['queued', 'running', 'completed', 'failed', 'canceled'], 'description': 'Current durable job state.'}, 'cacheHit': {'type': 'boolean'}, 'jobToken': {'type': 'string', 'description': 'Private bearer token required to read, refine, or export this job.'}, 'retryUrl': {'type': 'string', 'description': 'Authenticated REST URL for creating a replacement after retryable failure.'}, 'cancelUrl': {'type': 'string', 'description': 'Authenticated REST URL for canceling queued or running work.'}, 'exportUrl': {'type': 'string', 'description': 'Authenticated CSV export URL. Add format=json for JSON.'}, 'statusUrl': {'type': 'string', 'description': 'Authenticated REST URL for job status and result pages.'}, 'resultCount': {'type': 'integer'}, 'expiresInSeconds': {'type': 'integer', 'description': 'Seconds until the private job and token expire.'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'target': {'type': 'string', 'maxLength': 220, 'minLength': 3, 'description': 'Fictional business type echoed into deterministic test results.'}, 'geography': {'type': 'string', 'maxLength': 140, 'minLength': 2, 'description': 'Fictional location echoed into deterministic test results.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['schemaVersion', 'requestId', 'resultCount', 'returnedCount', 'offset', 'limit', 'hasMore', 'results', 'searchedSources', 'warnings'], 'properties': {'limit': {'type': 'integer', 'description': 'Maximum prospects requested for this page.'}, 'offset': {'type': 'integer', 'description': 'Zero-based offset of this page.'}, 'hasMore': {'type': 'boolean', 'description': 'Whether another result page is available.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'prospectStatus', 'whyMatch', 'criteria', 'contactRoute'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'website': {'type': 'string'}, 'criteria': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': True}}, 'whyMatch': {'type': 'array', 'items': {'type': 'string'}}, 'fitStatus': {'enum': ['verified', 'likely']}, 'confidence': {'type': 'number'}, 'sourceUrls': {'type': 'array', 'items': {'type': 'string'}}, 'websiteUrl': {'type': 'string'}, 'contactRoute': {'type': 'object', 'additionalProperties': True}, 'prospectStatus': {'enum': ['qualified', 'possible']}, 'evidenceQuality': {'enum': ['strong', 'moderate', 'weak']}, 'entityConfidence': {'type': 'number'}, 'qualificationChecks': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'qualificationConfidence': {'type': 'number'}}, 'additionalProperties': True}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Limitations the agent should retain with downstream data.'}, 'requestId': {'type': 'string', 'description': 'Request identifier for support and diagnostics.'}, 'durationMs': {'type': 'integer'}, 'nextOffset': {'type': ['integer', 'null'], 'description': 'Offset for the next synchronous result page, or null when complete.'}, 'diagnostics': {'type': 'object', 'description': 'Source status and explained candidate exclusions.', 'additionalProperties': True}, 'resultCount': {'type': 'integer', 'description': 'Total accepted prospects before response pagination.'}, 'returnedCount': {'type': 'integer', 'description': 'Prospects returned in this response page.'}, 'schemaVersion': {'type': 'string', 'description': 'Version of the result contract.'}, 'searchedSources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Discovery and first-party source types consulted.'}, 'remainingFreeSearches': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'target': {'type': 'string'}, 'website': {'type': 'string'}, 'business': {'type': 'string'}, 'geography': {'type': 'string'}, 'reviewUrls': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 3}, 'googlePlaceId': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'id': {'type': 'string'}, 'status': {'type': 'string'}, 'reports': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'limitations': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['target', 'geography'], 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum businesses in this response page.'}, 'fields': {'type': 'array', 'items': {'enum': ['Website', 'Business email', 'Phone', 'Location', 'Owner type', 'Description', 'Source links']}, 'description': 'Business fields to retain. Website and source evidence remain available for verification.'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Zero-based result offset for this response page.'}, 'output': {'enum': ['compact', 'full'], 'default': 'compact', 'description': 'Compact minimizes tokens. Full preserves every returned field.'}, 'target': {'type': 'string', 'maxLength': 220, 'minLength': 3, 'description': 'Business type or concise target.'}, 'geography': {'type': 'string', 'maxLength': 140, 'minLength': 2, 'description': 'City, region, country, or Worldwide.'}, 'qualifier': {'type': 'string', 'maxLength': 900, 'description': 'Optional required signals and exclusions that can be checked in public evidence.'}, 'includeDiagnostics': {'type': 'boolean', 'default': True, 'description': 'Include source status and explained exclusions.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['schemaVersion', 'requestId', 'resultCount', 'returnedCount', 'offset', 'limit', 'hasMore', 'results', 'searchedSources', 'warnings'], 'properties': {'limit': {'type': 'integer', 'description': 'Maximum prospects requested for this page.'}, 'offset': {'type': 'integer', 'description': 'Zero-based offset of this page.'}, 'hasMore': {'type': 'boolean', 'description': 'Whether another result page is available.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'prospectStatus', 'whyMatch', 'criteria', 'contactRoute'], 'properties': {'city': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'website': {'type': 'string'}, 'criteria': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': True}}, 'whyMatch': {'type': 'array', 'items': {'type': 'string'}}, 'fitStatus': {'enum': ['verified', 'likely']}, 'confidence': {'type': 'number'}, 'sourceUrls': {'type': 'array', 'items': {'type': 'string'}}, 'websiteUrl': {'type': 'string'}, 'contactRoute': {'type': 'object', 'additionalProperties': True}, 'prospectStatus': {'enum': ['qualified', 'possible']}, 'evidenceQuality': {'enum': ['strong', 'moderate', 'weak']}, 'entityConfidence': {'type': 'number'}, 'qualificationChecks': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'qualificationConfidence': {'type': 'number'}}, 'additionalProperties': True}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Limitations the agent should retain with downstream data.'}, 'requestId': {'type': 'string', 'description': 'Request identifier for support and diagnostics.'}, 'durationMs': {'type': 'integer'}, 'nextOffset': {'type': ['integer', 'null'], 'description': 'Offset for the next synchronous result page, or null when complete.'}, 'diagnostics': {'type': 'object', 'description': 'Source status and explained candidate exclusions.', 'additionalProperties': True}, 'resultCount': {'type': 'integer', 'description': 'Total accepted prospects before response pagination.'}, 'returnedCount': {'type': 'integer', 'description': 'Prospects returned in this response page.'}, 'schemaVersion': {'type': 'string', 'description': 'Version of the result contract.'}, 'searchedSources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Discovery and first-party source types consulted.'}, 'remainingFreeSearches': {'type': 'integer'}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['brief']}, {'required': ['target', 'geography']}], 'properties': {'brief': {'type': 'string', 'maxLength': 500, 'minLength': 8, 'description': 'Natural-language business, geography, required signals, and exclusions. Use this instead of separate target and geography.'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 50, 'minimum': 1, 'description': 'Maximum accepted prospects retained by the job.'}, 'fields': {'type': 'array', 'items': {'enum': ['Website', 'Business email', 'Phone', 'Location', 'Owner type', 'Description', 'Source links']}, 'description': 'Business fields to retain. Website and source evidence remain available for verification.'}, 'target': {'type': 'string', 'maxLength': 220, 'minLength': 3, 'description': 'Business type or concise ideal-customer target. Pair with geography when brief is omitted.'}, 'geography': {'type': 'string', 'maxLength': 140, 'minLength': 2, 'description': 'City, region, country, or Worldwide. Required with target when brief is omitted.'}, 'qualifier': {'type': 'string', 'maxLength': 900, 'description': 'Publicly verifiable requirements and exclusions.'}, 'idempotencyKey': {'type': 'string', 'maxLength': 128, 'minLength': 8, 'description': 'Stable key for safely retrying the same job creation request.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'status', 'statusUrl', 'exportUrl', 'retryUrl', 'cancelUrl', 'expiresInSeconds'], 'properties': {'id': {'type': 'string', 'description': 'Stable job identifier. Use it with jobToken in every lifecycle call.'}, 'status': {'enum': ['queued', 'running', 'completed', 'failed', 'canceled'], 'description': 'Current durable job state.'}, 'cacheHit': {'type': 'boolean'}, 'jobToken': {'type': 'string', 'description': 'Private bearer token required to read, refine, or export this job.'}, 'retryUrl': {'type': 'string', 'description': 'Authenticated REST URL for creating a replacement after retryable failure.'}, 'cancelUrl': {'type': 'string', 'description': 'Authenticated REST URL for canceling queued or running work.'}, 'exportUrl': {'type': 'string', 'description': 'Authenticated CSV export URL. Add format=json for JSON.'}, 'statusUrl': {'type': 'string', 'description': 'Authenticated REST URL for job status and result pages.'}, 'resultCount': {'type': 'integer'}, 'expiresInSeconds': {'type': 'integer', 'description': 'Seconds until the private job and token expire.'}}, 'additionalProperties': True}