Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.
Proxy networks troubleshooting
Error codes and description for proxy networks can be found here
Datasets API errors
200 ok (with error/status messages)
While technically a successful HTTP status, these responses carry messages indicating an ongoing process or a specific failure within the operation, requiring developer attention.
Message
Associated endpoints
Cause
Suggested action
{status: "STATUS", message: "Snapshot is not ready yet, try again in 10s"}
GET /datasets/v3/snapshot/:snapshot_id
The snapshot is still being built or processed.
This is an interim status. Poll the endpoint again after the suggested delay (e.g., 10s).
{status: "building", message: "Snapshot is building, try again in 10s"}
GET /datasets/v3/snapshot/:snapshot_id
The snapshot is actively being built.
Poll the endpoint again after the suggested delay.
Check the specific ERROR_MESSAGE for details. Review your collection setup and inputs.
Something went wrong. Bright Data is looking into it.
GET /datasets/v3/progress/:snapshot_id
An internal system error occurred during monitoring.
This indicates a problem on Bright Data’s end. No immediate action is required from your side, but you can contact support if it persists.
Account is suspended
GET /datasets/v3/progress/:snapshot_id
Your Bright Data account has been suspended, often due to a negative balance.
Top up your account balance. If suspension extends beyond 24 hours, previously allocated static IPs may be released. Go to your Bright Data Zones page for updated IPs.
Account is new, please activate it in account settings. URL
GET /datasets/v3/progress/:snapshot_id
Your newly created account requires activation.
Log in to your Bright Data account settings and complete the activation process.
No data found in discovery
GET /datasets/v3/progress/:snapshot_id
The discovery phase of your collection did not yield any data.
Review your discovery configuration and target settings.
Snapshot is empty
GET /datasets/v3/progress/:snapshot_id
The completed snapshot contains no data.
Check your collection process and dataset configuration to ensure data is being collected.
Failed to deliver snapshot
GET /datasets/v3/progress/:snapshot_id
An error occurred during the process of delivering the collected data to storage.
Review your delivery options and try again. If the issue persists, contact support.
Failed to download response
GET /datasets/v3/progress/:snapshot_id
An error occurred while attempting to download the response.
This could be a transient network issue or a problem on Bright Data’s side. Retry the request.
Failed to trigger collector
GET /datasets/v3/progress/:snapshot_id
An internal error prevented the collection from being triggered.
Retry the request. If the issue persists, contact support.
Internal server error
GET /datasets/v3/progress/:snapshot_id
A general internal server error.
Retry the request. If the issue persists, contact support.
Input validation failed: DETAILS
GET /datasets/v3/progress/:snapshot_id
There was an internal validation error with the input.
Review your input against the API documentation. If it appears correct, contact support.
202 accepted
Cause: The request has been accepted for processing, but the operation is not yet complete. This is typically an interim status indicating that a resource is being prepared or built.
Message
Associated Endpoint(s)
Cause
Suggested Action
{status: "STATUS", message: "Snapshot is not ready yet, try again in 10s"}
GET /datasets/v3/snapshot/:snapshot_id
The snapshot is still being built or processed.
This is an interim status. Poll the endpoint again after the suggested delay (e.g., 10s).
{status: "building", message: "Snapshot is building, try again in 10s"}
GET /datasets/v3/snapshot/:snapshot_id
The snapshot is actively being built.
Poll the endpoint again after the suggested delay.
400 bad request
Cause: Your request was invalid, malformed, or contained incorrect parameters. This is a common client-side error, indicating an issue with how the request was constructed.
Message
Associated Endpoint(s)
Cause
Suggested Action
{validation_errors: [ERRORS]}
Many Scrapers Library endpoints, GET /datasets/v3/snapshots, Marketplace Dataset API
General validation failure for request inputs; the ERRORS array will provide specific details.
Check the ERRORS array for specific validation issues and correct your request payload.
dataset missing
POST /datasets/v3/trigger
The required dataset ID or name is missing from the request.
Ensure the dataset identifier is included in your request.
Invalid attachments
POST /datasets/v3/trigger
The attachments provided are not valid.
Verify the format and content of your attachments.
This dataset is not allowed for API
POST /datasets/v3/trigger
The specified dataset cannot be triggered via API.
Confirm that the dataset is configured for API access.
This dataset is not ready yet
POST /datasets/v3/trigger
The dataset is still being prepared or is not in an active state.
Wait for the dataset to become ready before attempting to trigger a collection.
No data to trigger
POST /datasets/v3/trigger
The dataset has no inputs or configuration to initiate a collection.
Ensure your dataset has valid inputs defined.
Should be at least LIMIT inputs
POST /datasets/v3/trigger
The request does not meet the minimum number of required inputs.
Provide at least the specified LIMIT number of inputs.
Snapshot is expired
GET /datasets/v3/snapshot/:snapshot_id, POST /datasets/v3/deliver/:snapshot_id
The snapshot you are trying to access has passed its validity period.
Trigger a new collection to generate a fresh snapshot.
Snapshot is empty
GET /datasets/v3/snapshot/:snapshot_id, POST /datasets/v3/deliver/:snapshot_id
The collected snapshot contains no data.
Check your collection process and dataset configuration to ensure data is being collected.
Snapshot is not ready
GET /datasets/v3/snapshot/:snapshot_id/parts, POST /datasets/v3/deliver/:snapshot_id
The snapshot is still being processed or is not in a state to be downloaded or delivered.
Wait for the snapshot to complete processing. You can monitor its status via the “Monitor progress” endpoint.
Snapshot input does not exist
GET /datasets/v3/snapshot/:snapshot_id/input
The input file associated with the snapshot could not be found.
Verify the snapshot_id and ensure the input file was successfully generated.
Snapshot is not running
POST /datasets/v3/snapshot/:snapshot_id/cancel
You attempted to cancel a collection that is not currently active.
Check the status of the collection before attempting to cancel it.
Deliver options are missing
POST /datasets/v3/deliver/:snapshot_id
Required delivery configuration (e.g., destination details) was not provided.
Ensure all necessary delivery options are included in your request.
Snapshot is too big for single file delivery
POST /datasets/v3/deliver/:snapshot_id
The collected data exceeds the limit for a single file delivery.
Consider delivering the snapshot in multiple parts or adjusting your collection scope.
Batch size should be at least MIN_BATCH_SIZE
POST /datasets/v3/deliver/:snapshot_id
The specified batch size for delivery is below the minimum allowed.
Increase the batch_size to at least MIN_BATCH_SIZE.
{"validation_errors":["\"type\" must be one of [discover_new, url_collection]"]}
Marketplace Dataset API
The request uses an unsupported type.
Use discover_new or url_collection.
Type ${init_types.update_existing} is no longer supported.
Marketplace Dataset API
The requested operation type is no longer supported.
Use a supported operation type.
Initiation reason is required.
Marketplace Dataset API
The request is missing the required initiation reason.
Include the initiation reason in your request.
This feature is not available.
Marketplace Dataset API
The requested feature is not supported for the dataset.
Check the dataset’s capabilities and adjust your request accordingly.
This dataset was rejected.
Marketplace Dataset API
The dataset was rejected and cannot be processed.
This dataset cannot be used. Contact Bright Data support for more information.
This dataset is not ready.
Marketplace Dataset API
The dataset is not in a state where it can be processed.
Wait for the dataset to become ready.
This dataset does not support discovery. Supported types: ['${init_types.url_collection}']
Marketplace Dataset API
The dataset does not support the requested discovery type.
Use a supported discovery type, such as url_collection.
Incorrect discovery collector id.
Marketplace Dataset API
The discovery collector ID provided in the request is invalid.
Verify the discovery collector ID.
View not found.
Marketplace Dataset API
The requested view is not available.
Check for correct view names and available views for the dataset.
This dataset does not support collection.
Marketplace Dataset API
The dataset does not support the requested collection operation.
Use an operation supported by the dataset.
Batch size must be at least 1000.
Marketplace Dataset API
The batch size specified in the request is below the minimum allowed value.
Increase the batch_size to at least 1000.
{error: 'Snapshot failed'}
Marketplace Dataset API
The snapshot operation failed.
Review the collection process for underlying issues.
{error: 'Invalid snapshot type'}
Marketplace Dataset API
The snapshot type provided in the request is invalid.
Use a valid snapshot type.
401 unauthorized
Cause: Your request lacks valid authentication credentials for the API.
Message
Associated Endpoint(s)
Cause
Suggested Action
Unauthorized
Marketplace Dataset API
The API key or authentication credentials provided are invalid or missing.
Ensure your API key and authentication credentials are correct and properly included in the request.
402 payment required
Cause: Your account balance is insufficient to process the requested API operation.
Message
Associated Endpoint(s)
Cause
Suggested Action
{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}
Marketplace Dataset API
The user’s account balance is insufficient to process the request.
Add funds to your Bright Data account or adjust your request parameters to reduce its cost.
403 forbidden
Cause: You do not have permission to access the requested API resource, or your request is being blocked by a Bright Data policy.
Message
Associated Endpoint(s)
Cause
Suggested Action
Access denied.
Marketplace Dataset API
The user does not have the necessary permissions to access the resource.
Check your account permissions and ensure you have access to the requested resource.
Cannot skip billing.
Marketplace Dataset API
The user attempted to skip billing, which is not allowed.
Billing
404 not found
Cause: The specific API resource you’re trying to access does not exist in the system. You may encounter this error when trying to access a dataset, snapshot, delivery, or a general request that isn’t found.
Message
Associated Endpoint(s)
Cause
Suggested Action
dataset does not exist
POST /datasets/v3/trigger, Marketplace Dataset API
The specified dataset ID or name could not be found.
Double-check the dataset identifier in your request.
Snapshot does not exist
Many scrapers endpoints, Marketplace Dataset API
The snapshot_id provided does not correspond to an existing snapshot.
Verify the snapshot_id. It might be incorrect, expired, or never existed.
Delivery does not exist
GET /datasets/v3/delivery/:delivery_id
The delivery_id provided could not be found.
Confirm the delivery_id is correct.
Request not found
Scraper Studio API, Marketplace Dataset API
The specified request ID or other request details were not found in the Bright Data Marketplace Dataset API.
Verify your request details and ensure they are valid.
Page not found
Invalid URL, which suggests the URL might be broken or dead (specific to Web Unlocker API).
Verify the URL is correct and active.
422 unprocessable entity
Cause: The API request was well-formed but could not be processed due to semantic errors in the data provided.
Message
Associated Endpoint(s)
Cause
Suggested Action
{error: 'Provided filter did not match any records'}
Marketplace Dataset API
The filter provided in the request did not match any records in the dataset.
Adjust your filter criteria to match existing records in the dataset.
429 too many requests
Cause: You have exceeded a rate limit or the maximum number of parallel jobs allowed for your account or dataset when using the API.
Message
Associated Endpoint(s)
Cause
Suggested Action
You have too many running jobs for this dataset.
POST /datasets/v3/trigger
You’ve hit the concurrency limit for collection jobs on this dataset.
Wait for some active jobs to complete. For large workloads, consider combining multiple inputs into a single collection request to reduce concurrency.
{error: 'Maximum limit of 25 jobs per dataset has been exceeded'}
Marketplace Dataset API
You have exceeded the maximum allowed number of parallel jobs for the dataset.
Reduce the number of concurrent jobs, or wait for existing jobs to complete before initiating new ones.
This error code implies a rate limit (rare) and auto-throttling by Bright Data (specific to Web Unlocker API).
Cause: An unexpected error occurred on the Bright Data API server. These are server-side issues that are typically outside of your direct control.
Message
Associated Endpoint(s)
Cause
Suggested Action
Internal server error
Many Scrapers Library endpoints, GET /datasets/v3/snapshots, Marketplace Dataset API
A general, unhandled server-side error occurred.
This is typically a temporary issue. Retry your request after a short delay. If the problem persists, contact Bright Data support with the request details and any error messages.
Internal error.
Marketplace Dataset API
An unexpected error occurred on the server.
This is a server-side issue. Retry the request. If the problem persists, contact Bright Data support.
502 bad gateway
Cause: The Bright Data API server received an invalid response from an upstream server.
Message
Associated Endpoint(s)
Cause
Suggested Action
Unexpected error. The server encountered an unexpected error while processing the request.
Marketplace Dataset API
The server encountered an unexpected error while processing the request.
This is typically a temporary server-side issue. Retry the request. If it persists, contact support.
503 service unavailable
Message
Associated Endpoint(s)
Cause
Suggested Action
Service Unavailable
Specific to Web Unlocker API
Browser check failed or browser check wasn’t completed.
This indicates a temporary service unavailability or a browser rendering issue. Retry the request. If it persists, contact support.
Dataset API errors
400 - Bad Request
Indicates that the request was invalid or cannot be processed.
Error Message
Cause
{validation_errors: ["filter.name is required"]}
The request is missing a required filter parameter (e.g., filter.name).
{validation_errors: ["Invalid input provided"]}
The input provided in the request is not valid.
{"validation_errors":["\"type\" must be one of [discover_new, url_collection]"]}
The request uses an unsupported type. Use discover_new or url_collection.
Initiation reason is required.
The request is missing the required initiation reason.
This feature is not available.
The requested feature is not supported for the dataset.
This dataset was rejected.
The dataset was rejected and cannot be processed.
This dataset is not ready.
The dataset is not in a state where it can be processed.
This dataset does not support discovery. Supported types: ['${init_types.url_collection}']
The dataset does not support the requested discovery type.
Incorrect discovery collector id.
The discovery collector ID provided in the request is invalid.
View not found.
The requested view is not available.
This dataset does not support collection.
The dataset does not support the requested collection operation.
Batch size must be at least 1000.
The batch size specified in the request is below the minimum allowed value.
{error: 'Snapshot failed'}
The snapshot operation failed.
{error: 'Snapshot not ready'}
The snapshot is not ready for processing.
{error: 'Invalid snapshot type'}
The snapshot type provided in the request is invalid.
{validation_errors: [e.message]}
A validation error occurred, and the specific message is included in the response.
401 - Unauthorized
Indicates that the user is not authorized to access the requested resource.
Error Message
Cause
Unauthorized
The API key or authentication credentials provided are invalid or missing.
402 - Payment Required
Indicates that the user does not have sufficient funds to process the request.
Error Message
Cause
{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}
The user’s account balance is insufficient to process the request.
403 - Forbidden
Indicates that the user does not have permission to access the requested resource.
Error Message
Cause
Access denied.
The user does not have the necessary permissions to access the resource.
Cannot skip billing.
The user attempted to skip billing, which is not allowed.
404 - Not Found
Indicates that the requested resource could not be found.
Error Message
Cause
{error: 'Dataset not found'}
The specified dataset ID does not exist.
{error: 'Snapshot not found'}
The specified snapshot ID does not exist.
Dataset does not exist.
The dataset referenced in the request does not exist.
Request not found.
The specified request ID does not exist.
422 - Unprocessable Entity
Indicates that the request was well-formed but could not be processed due to semantic errors.
Error Message
Cause
{error: 'Provided filter did not match any records'}
The filter provided in the request did not match any records in the dataset.
429 - Too Many Requests
Indicates that the user has exceeded the rate limit or the maximum number of parallel jobs.
Error Message
Cause
Maximum limit of 25 jobs per dataset has been exceeded
The user has exceeded the maximum allowed number of parallel jobs for the dataset.
500 - Internal Server Error
Indicates that an unexpected error occurred on the server.
Error Message
Cause
Internal error.
An unexpected error occurred on the server.
502 - Bad Gateway
Indicates that the server received an invalid response from an upstream server.
Error Message
Cause
Unexpected error.
The server encountered an unexpected error while processing the request.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bright Data Docs","description":"Documentation for Bright Data proxies, Web Unlocker API, SERP API, Web Scraper API, Browser API, Bright Data MCP, datasets and the CLI.","colors":{"primary":"#4180f9","light":"#4180f9","dark":"#4180f9"},"logo":{"light":"https://mintcdn.com/brightdata/FreEYbEGZchU-2Iw/logo/light.svg?fit=max\u0026auto=format\u0026n=FreEYbEGZchU-2Iw\u0026q=85\u0026s=fa5461a75d0b4cf2e744c89d4b67afac","dark":"https://mintcdn.com/brightdata/FreEYbEGZchU-2Iw/logo/dark.svg?fit=max\u0026auto=format\u0026n=FreEYbEGZchU-2Iw\u0026q=85\u0026s=43d5b51e1516be57edb429337abdc90f","href":"https://brightdata.com/"},"favicon":"https://mintcdn.com/brightdata/5sJgYq9iW-Vo_7rr/favicon.svg?fit=max\u0026auto=format\u0026n=5sJgYq9iW-Vo_7rr\u0026q=85\u0026s=1b96b56f36033019c22871f4799240b0","api":{"mdx":{"auth":{"method":"bearer","name":"API_KEY"}}},"navbar":{"links":[{"href":"https://help.brightdata.com/hc/en-us/requests/new","label":"Support"}],"primary":{"type":"button","label":"Sign up","href":"https://brightdata.com/?hs_signup=1\u0026utm_source=docs"}},"footer":{"socials":{"linkedin":"https://il.linkedin.com/company/bright-data","youtube":"https://www.youtube.com/channel/UCM_0cG1ljAoEUcZIyoUIq6g","github":"https://github.com/luminati-io"}},"styling":{"eyebrows":"section","latex":true},"integrations":{"ga4":{"measurementId":"G-20NKMKN19K"},"gtm":{"tagId":"GTM-P69HL92P"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"cn","href":"cn/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"brightdata","hasAudioNarration":false,"actualSubdomain":"brightdata","customDomains":["docs.brightdata.com"],"gitSource":{"type":"github","owner":"luminati-io","repo":"webdocs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff01e11c16aa85135ee23c","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"en","tag":"Data extraction","count":354},{"language":"cn","tag":"数据提取","count":354},{"language":"en","tag":"API reference","count":340},{"language":"cn","tag":"API 参考","count":339},{"language":"en","tag":"Documentation","count":206},{"language":"cn","tag":"文档","count":206},{"language":"en","tag":"Scraper API","count":157},{"language":"cn","tag":"Scraper API","count":157},{"language":"en","tag":"Integrations","count":110},{"language":"cn","tag":"集成","count":110},{"language":"en","tag":"SERP API","count":96},{"language":"cn","tag":"SERP API","count":96},{"language":"en","tag":"Social Media APIs","count":66},{"language":"cn","tag":"社交媒体 API","count":66},{"language":"cn","tag":"管理 API","count":64},{"language":"en","tag":"Administrative APIs","count":51},{"language":"en","tag":"Account Management API","count":51},{"language":"cn","tag":"账号管理 API","count":51},{"language":"cn","tag":"代理网络","count":47},{"language":"en","tag":"Proxy","count":46}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"api-reference/style.css","content":".scrollable-list{max-height:150px;overflow-y:auto;border:1px solid #ccc;padding:10px;width:200px;margin:20px}.scrollable-list ul{padding:0;margin:0}.scrollable-list li{transition:transform 0.3s ease, background-color 0.3s ease;padding:5px;margin:4px 0;background-color:#f5f5f5;list-style:none}.scrollable-list li:hover{transform:translateX(10px);background-color:#e0f7fa}"},{"filePath":"style.css","content":"footer{margin-top:2rem}div:has(>div.flex.flex-row-reverse>div.relative.grow>div.mdx-content>.bd-landing){max-width:none!important}div.mdx-content:has(>.bd-landing),div.prose:has(>.bd-landing){max-width:none!important;width:100%!important}div:has(>div.mdx-content>.bd-landing)>header.relative.leading-none,div:has(>div.mdx-content>.bd-landing)>header{display:none!important}.bd-landing{width:100%;max-width:100%}.bd-landing{--bd-primary: #4180f9;--bd-primary-tint: rgba(65, 128, 249, 0.08);--bd-primary-border: rgba(65, 128, 249, 0.25)}.bd-page{width:100%;max-width:100%;margin:0 auto;padding:0 0 3rem;box-sizing:border-box}.bd-hero{display:grid;grid-template-columns:1fr;gap:2rem;align-items:start;margin:0.5rem 0 1.25rem}@media (min-width: 960px){.bd-hero{grid-template-columns:minmax(0, 1.1fr) minmax(0, 1fr);gap:3rem}}.bd-hero-copy{min-width:0}.bd-hero-image{min-width:0;max-width:100%;display:flex;align-items:center;justify-content:center}.bd-hero-image img{width:100%;max-width:480px;max-height:360px;height:auto;object-fit:contain;display:block}.bd-eyebrow{display:inline-block;font-size:0.75rem;font-weight:600;color:var(--bd-primary);text-transform:uppercase;letter-spacing:0.08em;margin-bottom:0.75rem}.bd-hero-copy .bd-headline,h1.bd-headline{font-size:2.75rem!important;font-weight:800!important;line-height:1.05!important;margin:0 0 1rem!important;letter-spacing:-0.025em!important;display:block!important;text-wrap:balance}.bd-hero-copy .bd-headline>a,.bd-hero-copy .bd-headline::before{display:none!important}.bd-subhead{font-size:1.125rem;line-height:1.6;color:#475569;margin:0 0 1.5rem;max-width:38rem}.dark .bd-subhead{color:#cbd5e1}.bd-cta-row{display:flex;flex-wrap:wrap;gap:0.75rem;margin:1.25rem 0 0}.bd-cta-row a.bd-cta-primary,.bd-cta-row a.bd-cta-secondary{display:inline-flex;align-items:center;gap:0.5rem;padding:0.75rem 1.25rem;border-radius:8px;font-size:0.9375rem;font-weight:600;text-decoration:none!important;transition:all 0.15s ease}.bd-cta-row a.bd-cta-primary{background:var(--bd-primary);color:#fff!important;border:1px solid var(--bd-primary)}.bd-cta-row a.bd-cta-primary:hover{background:#2f6ce8;transform:translateY(-1px);box-shadow:0 6px 16px rgba(65, 128, 249, 0.25)}.bd-cta-row a.bd-cta-secondary{background:transparent;color:var(--bd-primary)!important;border:1px solid var(--bd-primary-border)}.bd-cta-row a.bd-cta-secondary:hover{background:var(--bd-primary-tint);border-color:var(--bd-primary)}.bd-callout{display:flex;align-items:center;gap:0.75rem;padding:0.875rem 1.25rem;margin:0 0 2rem;background:var(--bd-primary-tint);border:1px solid var(--bd-primary-border);border-radius:10px;font-size:0.9375rem;line-height:1.5}.bd-callout a{color:var(--bd-primary)!important;font-weight:600;text-decoration:underline}.bd-callout-icon{flex:0 0 auto;font-size:1rem;line-height:1}.bd-pill{display:inline-block;padding:0.25rem 0.625rem;background:var(--bd-primary);color:#fff;border-radius:999px;font-size:0.6875rem;font-weight:700;text-transform:uppercase;letter-spacing:0.06em;vertical-align:middle}.bd-group-label{margin-top:0.5rem;margin-bottom:1rem}h3.bd-group-heading,.bd-page h3.bd-group-heading{font-size:0.8125rem!important;font-weight:700!important;text-transform:uppercase;letter-spacing:0.08em;color:#64748b!important;margin-top:2.5rem!important;margin-bottom:1rem!important;padding-left:0!important}.dark h3.bd-group-heading,.dark .bd-page h3.bd-group-heading{color:#94a3b8!important}h3.bd-group-heading::before,.bd-page h3.bd-group-heading::before{display:none!important;content:none!important}.bd-landing a[href]:has(>div),.bd-landing [class*=\"card\"]{transition:all 0.2s ease!important}.bd-landing a[href]:has(>div):hover,.bd-landing [class*=\"card\"]:hover{border-color:var(--bd-primary)!important;transform:translateY(-2px)!important;box-shadow:0 8px 24px rgba(65, 128, 249, 0.12)!important}.bd-landing svg[class*=\"icon\"],.bd-landing [class*=\"card\"] svg{color:var(--bd-primary)!important}.bd-page>h2{font-size:1.75rem!important;font-weight:700!important;margin-top:4rem!important;margin-bottom:1.25rem!important;line-height:1.2!important;position:relative;padding-left:1rem;color:inherit}.bd-page>h2::before{content:\"\";position:absolute;left:0;top:0.25rem;bottom:0.25rem;width:4px;background:var(--bd-primary);border-radius:2px}.bd-page>h2+p,.bd-page>h3+p{margin-top:0!important;margin-bottom:1.5rem!important;color:#64748b;font-size:1rem;line-height:1.6}.dark .bd-page>h2+p,.dark .bd-page>h3+p{color:#94a3b8}.bd-page>h3{font-size:1.125rem!important;font-weight:600!important;margin-top:2rem!important;margin-bottom:1rem!important;color:inherit}.bd-page>p{font-size:1rem;line-height:1.6;color:inherit;margin:0 0 1.5rem}div.mt-12>li>div{font-weight:600}div.mt-12>h5{font-weight:bolder}.bd-browse-all{display:inline-flex;align-items:center;gap:0.375rem;margin-top:1.25rem;margin-bottom:2rem;font-weight:600;color:var(--bd-primary)!important}.bd-credits{margin:1.5rem 0 0;font-size:0.875rem;line-height:1.6;color:#64748b}.dark .bd-credits{color:#94a3b8}.bd-hero-code{min-width:0;max-width:100%}.bd-hero-code pre{font-size:0.8125rem}.bd-hero{margin-bottom:3rem}.bd-page--plain>h2{padding-left:0!important}.bd-page--plain>h2::before{display:none!important;content:none!important}.bd-landing p.truncate{white-space:normal!important;overflow:visible!important;text-overflow:clip!important}.bd-landing a.tile,.bd-landing a.tile>div{align-items:flex-start!important;justify-content:flex-start!important;text-align:left!important}.bd-landing a.tile img{width:100%!important;align-self:stretch!important}.bd-catalog-row{display:grid;grid-template-columns:minmax(0, 1fr) minmax(0, 2fr);gap:2rem 3rem;padding:2.25rem 0}.bd-catalog-row+.bd-catalog-row{border-top:1px solid rgba(148, 163, 184, 0.18)}@media (max-width: 860px){.bd-catalog-row{grid-template-columns:1fr;gap:1rem}}.bd-catalog-info h3{font-size:1.1875rem!important;font-weight:600!important;margin:0 0 0.5rem!important}.bd-catalog-info h3 a,.bd-catalog-info h3::before{display:none!important}.bd-catalog-info p{margin:0;font-size:0.9375rem;line-height:1.6;color:#64748b;max-width:26rem}.dark .bd-catalog-info p{color:#94a3b8}.bd-catalog-items{display:grid;grid-template-columns:repeat(auto-fill, minmax(12.5rem, 1fr));gap:0.25rem 1rem;align-content:start}a.bd-catalog-item{display:flex;align-items:flex-start;gap:0.625rem;padding:0.5rem 0.625rem;border-radius:8px;font-size:0.9375rem;font-weight:500;color:inherit!important;text-decoration:none!important;border:none!important;transition:background 0.15s ease}a.bd-catalog-item:hover{background:rgba(65, 128, 249, 0.08)}a.bd-catalog-item:hover .bd-catalog-item-name{color:var(--bd-primary, #4180f9)}.bd-catalog-item-text{display:flex;flex-direction:column;gap:0.125rem;min-width:0}.bd-catalog-item-name{line-height:1.35}.bd-catalog-item-desc{font-size:0.8125rem;font-weight:400;line-height:1.45;color:#64748b}.dark .bd-catalog-item-desc{color:#94a3b8}a.bd-catalog-item svg{margin-top:0.2rem}a.bd-catalog-item svg,a.bd-catalog-item [class*=\"icon\"]{flex:0 0 auto;width:1rem;height:1rem;color:var(--bd-primary, #4180f9)}.bd-footer-links{display:flex;flex-wrap:wrap;gap:2rem;margin-top:5rem;padding-top:1.75rem;border-top:1px solid rgba(148, 163, 184, 0.25)}.bd-footer-links a{font-size:0.875rem;font-weight:500;color:#64748b!important;text-decoration:none!important}.bd-footer-links a:hover{color:var(--bd-primary)!important}.dark .bd-footer-links a{color:#94a3b8!important}.scrollable-list{max-height:150px;overflow-y:auto;border:1px solid #ccc;padding:10px;width:200px;margin:20px}.scrollable-list ul{padding:0;margin:0}.scrollable-list li{transition:transform 0.3s ease, background-color 0.3s ease;padding:5px;margin:4px 0;background-color:#f5f5f5;list-style:none}.scrollable-list li:hover{transform:translateX(10px);background-color:#e0f7fa}"}]}
{"page":{"pagePath":"api-reference/marketplace-dataset-api/troubleshooting","slug":"/api-reference/marketplace-dataset-api/troubleshooting","pageMetadata":{"title":"Troubleshooting","description":"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.","icon":"circle-exclamation","mode":"wide","href":"/api-reference/marketplace-dataset-api/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`proxy-networks-troubleshooting`,children:`Proxy networks troubleshooting`}),`\n`,_jsxs(_components.p,{children:[`Error codes and description for proxy networks can be found `,_jsx(_components.a,{href:`/proxy-networks/errorCatalog`,children:`here`})]}),`\n`,_jsx(Heading,{level:`2`,id:`datasets-api-errors`,children:`Datasets API errors`}),`\n`,_jsx(Heading,{level:`3`,id:`200-ok-with-error/status-messages`,children:`200 ok (with error/status messages)`}),`\n`,_jsx(_components.p,{children:`While technically a successful HTTP status, these responses carry messages indicating an ongoing process or a specific failure within the operation, requiring developer attention.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated endpoints`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{status: \"STATUS\", message: \"Snapshot is not ready yet, try again in 10s\"}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot is still being built or processed.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`This is an interim status. Poll the endpoint again after the suggested delay (e.g., `,_jsx(_components.code,{children:`10s`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{status: \"building\", message: \"Snapshot is building, try again in 10s\"}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot is actively being built.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Poll the endpoint again after the suggested delay.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{status: \"failed\", error_message: \"ERROR_MESSAGE\"}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`A collection or snapshot operation has failed.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Check the specific `,_jsx(_components.code,{children:`ERROR_MESSAGE`}),` for details. Review your collection setup and inputs.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Something went wrong. Bright Data is looking into it.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`An internal system error occurred during monitoring.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`This indicates a problem on Bright Data’s end. No immediate action is required from your side, but you can contact support if it persists.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Account is suspended`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Your Bright Data account has been suspended, often due to a negative balance.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Top up your account balance. If suspension extends beyond 24 hours, previously allocated static IPs may be released. Go to your Bright Data Zones page for updated IPs.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Account is new, please activate it in account settings. URL`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Your newly created account requires activation.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Log in to your Bright Data account settings and complete the activation process.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`No data found in discovery`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The discovery phase of your collection did not yield any data.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Review your discovery configuration and target settings.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot is empty`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The completed snapshot contains no data.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Check your collection process and dataset configuration to ensure data is being collected.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Failed to deliver snapshot`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`An error occurred during the process of delivering the collected data to storage.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Review your delivery options and try again. If the issue persists, contact support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Failed to download response`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`An error occurred while attempting to download the response.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`This could be a transient network issue or a problem on Bright Data’s side. Retry the request.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Failed to trigger collector`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`An internal error prevented the collection from being triggered.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Retry the request. If the issue persists, contact support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Internal server error`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`A general internal server error.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Retry the request. If the issue persists, contact support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Input validation failed: DETAILS`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/progress/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`There was an internal validation error with the input.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Review your input against the API documentation. If it appears correct, contact support.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`202-accepted`,children:`202 accepted`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` The request has been accepted for processing, but the operation is not yet complete. This is typically an interim status indicating that a resource is being prepared or built.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{status: \"STATUS\", message: \"Snapshot is not ready yet, try again in 10s\"}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot is still being built or processed.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`This is an interim status. Poll the endpoint again after the suggested delay (e.g., `,_jsx(_components.code,{children:`10s`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{status: \"building\", message: \"Snapshot is building, try again in 10s\"}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot is actively being built.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Poll the endpoint again after the suggested delay.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`400-bad-request`,children:`400 bad request`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Your request was invalid, malformed, or contained incorrect parameters. This is a common client-side error, indicating an issue with how the request was constructed.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{validation_errors: [ERRORS]}`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Many Scrapers Library endpoints, `,_jsx(_components.code,{children:`GET /datasets/v3/snapshots`}),`, Marketplace Dataset API`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`General validation failure for request inputs; the ERRORS array will provide specific details.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Check the ERRORS array for specific validation issues and correct your request payload.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`dataset missing`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The required dataset ID or name is missing from the request.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Ensure the dataset identifier is included in your request.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Invalid attachments`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The attachments provided are not valid.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Verify the format and content of your attachments.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset is not allowed for API`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The specified dataset cannot be triggered via API.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Confirm that the dataset is configured for API access.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset is not ready yet`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset is still being prepared or is not in an active state.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Wait for the dataset to become ready before attempting to trigger a collection.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`No data to trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset has no inputs or configuration to initiate a collection.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Ensure your dataset has valid inputs defined.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Should be at least LIMIT inputs`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The request does not meet the minimum number of required inputs.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Provide at least the specified `,_jsx(_components.code,{children:`LIMIT`}),` number of inputs.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot is expired`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id`}),`, `,_jsx(_components.code,{children:`POST /datasets/v3/deliver/:snapshot_id`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot you are trying to access has passed its validity period.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Trigger a new collection to generate a fresh snapshot.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot is empty`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id`}),`, `,_jsx(_components.code,{children:`POST /datasets/v3/deliver/:snapshot_id`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`The collected snapshot contains no data.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Check your collection process and dataset configuration to ensure data is being collected.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot is not ready`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id/parts`}),`, `,_jsx(_components.code,{children:`POST /datasets/v3/deliver/:snapshot_id`})]}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot is still being processed or is not in a state to be downloaded or delivered.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Wait for the snapshot to complete processing. You can monitor its status via the “Monitor progress” endpoint.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot input does not exist`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`GET /datasets/v3/snapshot/:snapshot_id/input`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The input file associated with the snapshot could not be found.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Verify the `,_jsx(_components.code,{children:`snapshot_id`}),` and ensure the input file was successfully generated.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot is not running`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/snapshot/:snapshot_id/cancel`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`You attempted to cancel a collection that is not currently active.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Check the status of the collection before attempting to cancel it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Deliver options are missing`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/deliver/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Required delivery configuration (e.g., destination details) was not provided.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Ensure all necessary delivery options are included in your request.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot is too big for single file delivery`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/deliver/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The collected data exceeds the limit for a single file delivery.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Consider delivering the snapshot in multiple parts or adjusting your collection scope.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Batch size should be at least MIN_BATCH_SIZE`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/deliver/:snapshot_id`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The specified batch size for delivery is below the minimum allowed.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Increase the `,_jsx(_components.code,{children:`batch_size`}),` to at least `,_jsx(_components.code,{children:`MIN_BATCH_SIZE`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{\"validation_errors\":[\"\\\\\"type\\\\\" must be one of [discover_new, url_collection]\"]}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The request uses an unsupported type.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Use discover_new or url_collection.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:\"Type ${init_types.update_existing} is no longer supported.\"})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The requested operation type is no longer supported.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Use a supported operation type.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Initiation reason is required.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The request is missing the required initiation reason.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Include the `,_jsx(_components.code,{children:`initiation reason`}),` in your request.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This feature is not available.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The requested feature is not supported for the dataset.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Check the dataset’s capabilities and adjust your request accordingly.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset was rejected.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset was rejected and cannot be processed.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`This dataset cannot be used. Contact Bright Data support for more information.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset is not ready.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset is not in a state where it can be processed.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Wait for the dataset to become ready.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:\"This dataset does not support discovery. Supported types: ['${init_types.url_collection}']\"})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset does not support the requested discovery type.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Use a supported discovery type, such as `,_jsx(_components.code,{children:`url_collection`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Incorrect discovery collector id.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The discovery collector ID provided in the request is invalid.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Verify the discovery collector ID.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`View not found.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The requested view is not available.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Check for correct view names and available views for the dataset.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset does not support collection.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset does not support the requested collection operation.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Use an operation supported by the dataset.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Batch size must be at least 1000.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The batch size specified in the request is below the minimum allowed value.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Increase the `,_jsx(_components.code,{children:`batch_size`}),` to at least 1000.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Snapshot failed'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot operation failed.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Review the collection process for underlying issues.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Invalid snapshot type'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot type provided in the request is invalid.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Use a valid snapshot type.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`401-unauthorized`,children:`401 unauthorized`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Your request lacks valid authentication credentials for the API.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Unauthorized`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The API key or authentication credentials provided are invalid or missing.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Ensure your API key and authentication credentials are correct and properly included in the request.`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`402-payment-required`,children:`402 payment required`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Your account balance is insufficient to process the requested API operation.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The user’s account balance is insufficient to process the request.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Add funds to your Bright Data account or adjust your request parameters to reduce its cost.`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`403-forbidden`,children:`403 forbidden`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` You do not have permission to access the requested API resource, or your request is being blocked by a Bright Data policy.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Access denied.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The user does not have the necessary permissions to access the resource.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Check your account permissions and ensure you have access to the requested resource.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Cannot skip billing.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The user attempted to skip billing, which is not allowed.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Billing`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`404-not-found`,children:`404 not found`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` The specific API resource you’re trying to access does not exist in the system. You may encounter this error when trying to access a dataset, snapshot, delivery, or a general request that isn’t found.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`dataset does not exist`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`POST /datasets/v3/trigger, Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The specified dataset ID or name could not be found.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Double-check the dataset identifier in your request.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Snapshot does not exist`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Many scrapers endpoints, Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot_id provided does not correspond to an existing snapshot.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Verify the snapshot_id. It might be incorrect, expired, or never existed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Delivery does not exist`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`GET /datasets/v3/delivery/:delivery_id`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The delivery_id provided could not be found.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Confirm the delivery_id is correct.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Request not found`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Scraper Studio API, Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The specified request ID or other request details were not found in the Bright Data Marketplace Dataset API.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Verify your request details and ensure they are valid.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Page not found`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Invalid URL, which suggests the URL might be broken or dead (specific to Web Unlocker API).`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Verify the URL is correct and active.`}),_jsx(_components.td,{style:{textAlign:`left`}})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`422-unprocessable-entity`,children:`422 unprocessable entity`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` The API request was well-formed but could not be processed due to semantic errors in the data provided.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Provided filter did not match any records'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The filter provided in the request did not match any records in the dataset.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Adjust your filter criteria to match existing records in the dataset.`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`429-too-many-requests`,children:`429 too many requests`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` You have exceeded a rate limit or the maximum number of parallel jobs allowed for your account or dataset when using the API.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`You have too many running jobs for this dataset.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`POST /datasets/v3/trigger`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`You’ve hit the concurrency limit for collection jobs on this dataset.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Wait for some active jobs to complete. For large workloads, consider combining multiple inputs into a single collection request to reduce concurrency.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Maximum limit of 25 jobs per dataset has been exceeded'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`You have exceeded the maximum allowed number of parallel jobs for the dataset.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Reduce the number of concurrent jobs, or wait for existing jobs to complete before initiating new ones.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`}}),_jsx(_components.td,{style:{textAlign:`left`},children:`This error code implies a rate limit (rare) and auto-throttling by Bright Data (specific to Web Unlocker API).`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Open a ticket or email `,_jsx(_components.a,{href:`mailto:support@brightdata.com`,children:`support@brightdata.com`}),` for assistance.`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Confirm the delivery_id is correct.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`500-internal-server-error`,children:`500 internal server error`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` An unexpected error occurred on the Bright Data API server. These are server-side issues that are typically outside of your direct control.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Internal server error`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Many Scrapers Library endpoints, `,_jsx(_components.code,{children:`GET /datasets/v3/snapshots`}),`, Marketplace Dataset API`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`A general, unhandled server-side error occurred.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`This is typically a temporary issue. Retry your request after a short delay. If the problem persists, contact Bright Data support with the request details and any error messages.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Internal error.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`An unexpected error occurred on the server.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`This is a server-side issue. Retry the request. If the problem persists, contact Bright Data support.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`502-bad-gateway`,children:`502 bad gateway`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` The Bright Data API server received an invalid response from an upstream server.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Unexpected error. The server encountered an unexpected error while processing the request.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Marketplace Dataset API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The server encountered an unexpected error while processing the request.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`This is typically a temporary server-side issue. Retry the request. If it persists, contact support.`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`503-service-unavailable`,children:`503 service unavailable`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Associated Endpoint(s)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Suggested Action`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Service Unavailable`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Specific to Web Unlocker API`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Browser check failed or browser check wasn’t completed.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`This indicates a temporary service unavailability or a browser rendering issue. Retry the request. If it persists, contact support.`})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`dataset-api-errors`,children:`Dataset API errors`}),`\n`,_jsx(Heading,{level:`3`,id:`400-bad-request-2`,children:`400 - Bad Request`}),`\n`,_jsx(_components.p,{children:`Indicates that the request was invalid or cannot be processed.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{validation_errors: [\"filter.name is required\"]}`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`The request is missing a required filter parameter (e.g., `,_jsx(_components.code,{children:`filter.name`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{validation_errors: [\"Invalid input provided\"]}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The input provided in the request is not valid.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{\"validation_errors\":[\"\\\\\"type\\\\\" must be one of [discover_new, url_collection]\"]}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The request uses an unsupported type. Use discover_new or url_collection.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Initiation reason is required.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The request is missing the required initiation reason.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This feature is not available.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The requested feature is not supported for the dataset.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset was rejected.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset was rejected and cannot be processed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset is not ready.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset is not in a state where it can be processed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:\"This dataset does not support discovery. Supported types: ['${init_types.url_collection}']\"})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset does not support the requested discovery type.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Incorrect discovery collector id.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The discovery collector ID provided in the request is invalid.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`View not found.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The requested view is not available.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`This dataset does not support collection.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset does not support the requested collection operation.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Batch size must be at least 1000.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The batch size specified in the request is below the minimum allowed value.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Snapshot failed'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot operation failed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Snapshot not ready'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot is not ready for processing.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Invalid snapshot type'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The snapshot type provided in the request is invalid.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{validation_errors: [e.message]}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`A validation error occurred, and the specific message is included in the response.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`401-unauthorized-2`,children:`401 - Unauthorized`}),`\n`,_jsx(_components.p,{children:`Indicates that the user is not authorized to access the requested resource.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Unauthorized`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The API key or authentication credentials provided are invalid or missing.`})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`402-payment-required-2`,children:`402 - Payment Required`}),`\n`,_jsx(_components.p,{children:`Indicates that the user does not have sufficient funds to process the request.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The user’s account balance is insufficient to process the request.`})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`403-forbidden-2`,children:`403 - Forbidden`}),`\n`,_jsx(_components.p,{children:`Indicates that the user does not have permission to access the requested resource.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Access denied.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The user does not have the necessary permissions to access the resource.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Cannot skip billing.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The user attempted to skip billing, which is not allowed.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`404-not-found-2`,children:`404 - Not Found`}),`\n`,_jsx(_components.p,{children:`Indicates that the requested resource could not be found.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Dataset not found'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The specified dataset ID does not exist.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Snapshot not found'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The specified snapshot ID does not exist.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Dataset does not exist.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The dataset referenced in the request does not exist.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Request not found.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The specified request ID does not exist.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`422-unprocessable-entity-2`,children:`422 - Unprocessable Entity`}),`\n`,_jsx(_components.p,{children:`Indicates that the request was well-formed but could not be processed due to semantic errors.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`{error: 'Provided filter did not match any records'}`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The filter provided in the request did not match any records in the dataset.`})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`429-too-many-requests-2`,children:`429 - Too Many Requests`}),`\n`,_jsx(_components.p,{children:`Indicates that the user has exceeded the rate limit or the maximum number of parallel jobs.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Maximum limit of 25 jobs per dataset has been exceeded`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`The user has exceeded the maximum allowed number of parallel jobs for the dataset.`})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`500-internal-server-error-2`,children:`500 - Internal Server Error`}),`\n`,_jsx(_components.p,{children:`Indicates that an unexpected error occurred on the server.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`Internal error.`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`An unexpected error occurred on the server.`})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`502-bad-gateway-2`,children:`502 - Bad Gateway`}),`\n`,_jsx(_components.p,{children:`Indicates that the server received an invalid response from an upstream server.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Error Message`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Cause`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Unexpected error.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`The server encountered an unexpected error while processing the request.`})]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Troubleshooting","description":"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.","icon":"circle-exclamation","mode":"wide","href":"/api-reference/marketplace-dataset-api/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Proxy networks troubleshooting","slug":"proxy-networks-troubleshooting","depth":2,"children":[]},{"title":"Datasets API errors","slug":"datasets-api-errors","depth":2,"children":[{"title":"200 ok (with error/status messages)","slug":"200-ok-with-error/status-messages","depth":3,"children":[]},{"title":"202 accepted","slug":"202-accepted","depth":3,"children":[]},{"title":"400 bad request","slug":"400-bad-request","depth":3,"children":[]},{"title":"401 unauthorized","slug":"401-unauthorized","depth":3,"children":[]},{"title":"402 payment required","slug":"402-payment-required","depth":3,"children":[]},{"title":"403 forbidden","slug":"403-forbidden","depth":3,"children":[]},{"title":"404 not found","slug":"404-not-found","depth":3,"children":[]},{"title":"422 unprocessable entity","slug":"422-unprocessable-entity","depth":3,"children":[]},{"title":"429 too many requests","slug":"429-too-many-requests","depth":3,"children":[]},{"title":"500 internal server error","slug":"500-internal-server-error","depth":3,"children":[]},{"title":"502 bad gateway","slug":"502-bad-gateway","depth":3,"children":[]},{"title":"503 service unavailable","slug":"503-service-unavailable","depth":3,"children":[]}]},{"title":"Dataset API errors","slug":"dataset-api-errors","depth":2,"children":[{"title":"400 - Bad Request","slug":"400-bad-request-2","depth":3,"children":[]},{"title":"401 - Unauthorized","slug":"401-unauthorized-2","depth":3,"children":[]},{"title":"402 - Payment Required","slug":"402-payment-required-2","depth":3,"children":[]},{"title":"403 - Forbidden","slug":"403-forbidden-2","depth":3,"children":[]},{"title":"404 - Not Found","slug":"404-not-found-2","depth":3,"children":[]},{"title":"422 - Unprocessable Entity","slug":"422-unprocessable-entity-2","depth":3,"children":[]},{"title":"429 - Too Many Requests","slug":"429-too-many-requests-2","depth":3,"children":[]},{"title":"500 - Internal Server Error","slug":"500-internal-server-error-2","depth":3,"children":[]},{"title":"502 - Bad Gateway","slug":"502-bad-gateway-2","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/brightdata/68bae243aeababfe/script.js","/_mintlify/custom/brightdata/c119bb67904233e1/nav-internal-links.js","/_mintlify/custom/brightdata/2dd0be8455e09562/prompt-copy-plaintext.js","/_mintlify/custom/brightdata/614f9419dc2a8785/marketing-attribution.js"],"subdomain":"brightdata","siteName":"Bright Data Docs","title":"Troubleshooting - Bright Data Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/marketplace-dataset-api/troubleshooting","matchLevel":0},"cn":{"href":"/cn/api-reference/marketplace-dataset-api/troubleshooting","matchLevel":1}}},"lastModified":"2026-11-13T04:13:52.699Z","originalFileLocation":"api-reference/marketplace-dataset-api/troubleshooting.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bright Data Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Troubleshooting - Bright Data Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bright Data Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://brightdata.mintlify.site/_mintlify/api/og/v2?division=Dataset+API\u0026amp;title=Troubleshooting\u0026amp;description=Troubleshoot+4xx+and+5xx+errors+from+the+Bright+Data+Web+Unlocker+API%2C+SERP+API%2C+Web+Scraper+API%2C+Marketplace+Dataset+API+and+Web+Scraper+IDE+with+fixes.\u0026amp;theme=7da10763b4cc41bb49d4e8a2\u0026amp;signature=d092119444a37875ec4ca6aeb66593e1f2070198b1bb8fe3e7509d2e0feef4e3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Troubleshooting - Bright Data Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://brightdata.mintlify.site/_mintlify/api/og/v2?division=Dataset+API\u0026amp;title=Troubleshooting\u0026amp;description=Troubleshoot+4xx+and+5xx+errors+from+the+Bright+Data+Web+Unlocker+API%2C+SERP+API%2C+Web+Scraper+API%2C+Marketplace+Dataset+API+and+Web+Scraper+IDE+with+fixes.\u0026amp;theme=7da10763b4cc41bb49d4e8a2\u0026amp;signature=d092119444a37875ec4ca6aeb66593e1f2070198b1bb8fe3e7509d2e0feef4e3\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/brightdata/uUUbPQlQGu6JyjN0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bright Data Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4180f9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/marketplace-dataset-api/troubleshooting.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.brightdata.com/cn/api-reference/marketplace-dataset-api/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.brightdata.com/#organization\",\"name\":\"Bright Data Docs\",\"url\":\"https://docs.brightdata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/brightdata/FreEYbEGZchU-2Iw/logo/light.svg?fit=max\u0026auto=format\u0026n=FreEYbEGZchU-2Iw\u0026q=85\u0026s=fa5461a75d0b4cf2e744c89d4b67afac\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.brightdata.com#website\",\"name\":\"Bright Data Docs\",\"url\":\"https://docs.brightdata.com\",\"publisher\":{\"@id\":\"https://docs.brightdata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting#webpage\",\"url\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.\",\"dateModified\":\"2026-11-13T04:13:52.699Z\",\"isPartOf\":{\"@id\":\"https://docs.brightdata.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Data extraction\",\"item\":\"https://docs.brightdata.com/products/scrapers/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Dataset\",\"item\":\"https://docs.brightdata.com/products/marketplace/dataset-view\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Dataset API\",\"item\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/overview\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Troubleshooting\",\"item\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting#article\",\"headline\":\"Troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.\",\"url\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting\",\"mainEntityOfPage\":{\"@id\":\"https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting#webpage\"},\"dateModified\":\"2026-11-13T04:13:52.699Z\",\"publisher\":{\"@id\":\"https://docs.brightdata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.brightdata.com#website\"}}]}\u003c/script>","agentPointerHref":"/api-reference/marketplace-dataset-api/troubleshooting.md","siteName":"Bright Data Docs","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"Bright Data documentation","sidebarTitle":"Introduction","icon":"page","mode":"wide","href":"/introduction"},{"group":"Quickstart","icon":"rocket","expanded":true,"pages":[{"title":"Bright Data quickstart","sidebarTitle":"For humans","icon":"user","href":"/quickstart"},{"title":"Bright Data for your coding agent","sidebarTitle":"For your coding agent","icon":"robot","href":"/quickstart-coding-agent"}]},{"title":"How to select the best product","sidebarTitle":"Choose a product","icon":"compass","href":"/product-selector"},{"group":"Concepts","icon":"lightbulb","pages":[{"title":"How Bright Data handles anti-bot blocking","sidebarTitle":"Anti-bot blocking","href":"/concepts/how-bright-data-handles-blocking"},{"title":"How to reduce web scraping costs","sidebarTitle":"Reducing costs","href":"/concepts/reducing-scraping-costs"},{"title":"Ethical web scraping best practices","sidebarTitle":"Ethical scraping","href":"/concepts/ethical-web-scraping"},{"title":"Modern scraping operations","sidebarTitle":"Modern scraping operations","href":"/concepts/modern-scraping-operations"},{"title":"Sync vs async requests","sidebarTitle":"Sync vs async","href":"/concepts/sync-vs-async"},{"title":"Scraper API vs DIY scraping","sidebarTitle":"Scraper API vs DIY","href":"/concepts/web-scraper-api-vs-diy"}]},{"group":"Tutorials","icon":"graduation-cap","pages":[{"title":"Build a keyword social listener","sidebarTitle":"Social listener","href":"/products/scrapers/tutorials/social-listener"},{"title":"Build a daily Amazon price monitor","sidebarTitle":"Amazon price monitor","href":"/products/scrapers/tutorials/amazon-price-monitor"},{"title":"Build a LinkedIn-to-CRM webhook pipeline","sidebarTitle":"LinkedIn to CRM","href":"/products/scrapers/tutorials/linkedin-to-crm"}]},{"group":"CLI","icon":"terminal","pages":[{"title":"Bright Data CLI","sidebarTitle":"Overview","icon":"terminal","href":"/products/cli/overview"},{"title":"Install the Bright Data CLI","sidebarTitle":"Installation","icon":"download","href":"/products/cli/installation"},{"title":"Bright Data CLI command reference","sidebarTitle":"Commands","icon":"code","href":"/products/cli/commands"},{"title":"Usage examples","sidebarTitle":"Examples","icon":"book-open","href":"/products/cli/examples"},{"title":"Bright Data CLI FAQs","sidebarTitle":"FAQs","icon":"question","href":"/products/cli/faqs"}]},{"group":"Bright Data MCP","icon":"server","pages":[{"title":"MCP server overview","sidebarTitle":"Overview","href":"/products/mcp-server/overview"},{"group":"Remote","pages":[{"title":"How to get started with remote MCP server","sidebarTitle":"Quickstart","href":"/products/mcp-server/remote/quickstart"},{"title":"Remote MCP server advanced configuration","sidebarTitle":"Advanced","href":"/products/mcp-server/remote/advanced"}]},{"group":"Local","pages":[{"title":"How to set up local (self-hosted) MCP","sidebarTitle":"Quickstart","href":"/products/mcp-server/local/quickstart"},{"title":"Local MCP server advanced configuration","sidebarTitle":"Advanced","href":"/products/mcp-server/local/advanced"}]},{"title":"Bright Data MCP tools","sidebarTitle":"Tools","mode":"wide","href":"/products/mcp-server/tools"},{"title":"MCP usage examples","sidebarTitle":"Usage Examples","href":"/products/mcp-server/usage-examples"},{"title":"TOON format for Bright Data MCP","sidebarTitle":"TOON format","href":"/products/mcp-server/toon"},{"title":"Bright Data MCP FAQs","sidebarTitle":"FAQs","href":"/products/mcp-server/faqs"}]},{"title":"Python SDK","sidebarTitle":"Python SDK","icon":"Python","href":"/api-reference/SDK"},{"sidebarTitle":"JavaScript SDK","icon":"node-js","title":"JavaScript SDK","href":"/api-reference/SDK-JS"}]},{"group":"Data extraction","pages":[{"group":"Scraper API","pages":[{"title":"Scraper API","sidebarTitle":"Overview","mode":"wide","href":"/products/scrapers/overview"},{"group":"Social media scrapers","icon":"users","pages":[{"group":"LinkedIn","pages":[{"title":"LinkedIn Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/linkedin/introduction"},{"title":"LinkedIn scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/linkedin/quickstart"},{"title":"LinkedIn Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/linkedin/send-first-request"}]},{"group":"Instagram","pages":[{"title":"Instagram Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/instagram/introduction"},{"title":"Instagram scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/instagram/quickstart"},{"title":"Instagram Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/instagram/send-first-request"}]},{"group":"TikTok","pages":[{"title":"TikTok Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/tiktok/introduction"},{"title":"TikTok scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/tiktok/quickstart"},{"title":"TikTok Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/tiktok/send-first-request"}]},{"group":"Facebook","pages":[{"title":"Facebook Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/facebook/introduction"},{"title":"Facebook scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/facebook/quickstart"},{"title":"Facebook Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/facebook/send-first-request"}]},{"group":"X (Twitter)","pages":[{"title":"X (Twitter) Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/twitter/introduction"},{"title":"X (Twitter) scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/twitter/quickstart"},{"title":"X (Twitter) Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/twitter/send-first-request"}]},{"group":"YouTube","pages":[{"title":"YouTube Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/youtube/introduction"},{"title":"YouTube scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/youtube/quickstart"},{"title":"YouTube Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/youtube/send-first-request"}]},{"group":"Reddit","pages":[{"title":"Reddit Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/reddit/introduction"},{"title":"Reddit scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/reddit/quickstart"},{"title":"Reddit Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/reddit/send-first-request"}]}]},{"group":"E-commerce scrapers","icon":"cart-shopping","pages":[{"group":"Amazon","pages":[{"title":"Amazon Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/amazon/introduction"},{"title":"Amazon scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/amazon/quickstart"},{"title":"Amazon Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/amazon/send-first-request"}]}]},{"group":"Search engine scrapers","icon":"magnifying-glass","pages":[{"group":"Google","pages":[{"title":"Google Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/google/introduction"},{"title":"Google scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/google/quickstart"},{"title":"Google Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/google/send-first-request"}]}]},{"group":"AI search scrapers","icon":"sparkles","pages":[{"group":"ChatGPT","pages":[{"title":"ChatGPT Scraper API","sidebarTitle":"Introduction","href":"/products/scrapers/chatgpt/introduction"},{"title":"ChatGPT scraper quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/chatgpt/quickstart"},{"title":"ChatGPT Scraper API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/chatgpt/send-first-request"},{"title":"Working with sources in AI scrapers","sidebarTitle":"Working with sources","href":"/products/scrapers/scrapers-library/working-with-sources"},{"title":"Query fan-out and web search control","sidebarTitle":"Query fan-out","href":"/products/scrapers/concepts/query-fan-out"}]}]},{"group":"Web content scrapers","icon":"globe","pages":[{"group":"Fetch API","pages":[{"title":"Fetch API","sidebarTitle":"Introduction","href":"/products/scrapers/fetch-api/introduction"},{"title":"Fetch API quickstart","sidebarTitle":"Quickstart","mode":"wide","href":"/products/scrapers/fetch-api/quickstart"},{"title":"Fetch API endpoints","sidebarTitle":"Endpoints","href":"/products/scrapers/fetch-api/send-first-request"}]}]},{"group":"How-to guides","pages":[{"title":"How to scrape in bulk with async requests","sidebarTitle":"Scrape in bulk","href":"/products/scrapers/scrapers-library/async-requests"},{"title":"How to deliver Scraper API results","sidebarTitle":"Deliver results","href":"/products/scrapers/scrapers-library/data-delivery"},{"title":"How to stream results and deliver files","sidebarTitle":"Stream results and files","href":"/products/scrapers/scrapers-library/stream-and-file-delivery"},{"title":"How to set up success rate alerts","sidebarTitle":"Set up success alerts","href":"/products/scrapers/scrapers-library/success-rate"}]},{"title":"Scraper API FAQs","sidebarTitle":"FAQs","href":"/products/scrapers/scrapers-library/faqs"},{"title":"Scraper API error codes","sidebarTitle":"Error codes","href":"/products/scrapers/error-codes"},{"title":"Scraper API limits","sidebarTitle":"Limits","href":"/products/scrapers/limits"},{"title":"Scraper API reference","sidebarTitle":"API reference","icon":"arrow-up-right-from-square","url":"/api-reference/rest-api/scraper/asynchronous-requests","href":"/products/scrapers/scrapers-library/api-reference"}]},{"group":"Scraper Studio","pages":[{"title":"Scraper Studio","sidebarTitle":"Overview","mode":"wide","href":"/products/scraper-studio/overview"},{"title":"Bright Data Scraper Studio API quickstart","sidebarTitle":"Scraper Studio quickstart","mode":"wide","href":"/products/scraper-studio/quickstart"},{"title":"When to use Scraper Studio","sidebarTitle":"Introduction","href":"/products/scraper-studio/introduction"},{"title":"Build a scraper with the AI Agent","sidebarTitle":"AI Agent","tag":"New","href":"/products/scraper-studio/ai-agent"},{"title":"Understanding the AI Scraper Studio APIs","sidebarTitle":"AI flow APIs","mode":"wide","href":"/api-reference/scraper-studio-api/ai-flow/overview"},{"title":"Build a scraper with the Bright Data CLI","sidebarTitle":"Bright Data CLI","tag":"New","href":"/products/scraper-studio/build-with-the-cli"},{"title":"Scraper Studio coding agent prompts","sidebarTitle":"Coding agent prompts","icon":"messages","href":"/products/scraper-studio/coding-agent-prompts"},{"group":"IDE","pages":[{"title":"Web scraping basics in Scraper Studio","sidebarTitle":"Basics","href":"/products/scraper-studio/basics-of-web-scraping"},{"title":"Develop a scraper with the IDE","sidebarTitle":"Develop a scraper","href":"/products/scraper-studio/develop-a-scraper"},{"title":"Scraper Studio IDE interface reference","sidebarTitle":"IDE interface","href":"/products/scraper-studio/scraper-studio-ide-interface"},{"title":"Scraper Studio worker types","sidebarTitle":"Worker types","href":"/products/scraper-studio/worker-types"},{"title":"Scraper Studio functions reference","sidebarTitle":"Functions","href":"/products/scraper-studio/functions"},{"title":"Input and output schema","sidebarTitle":"Input \u0026 output schema","href":"/products/scraper-studio/input-and-output-schema"},{"title":"Complete Scraper Studio IDE examples","sidebarTitle":"Complete examples","href":"/products/scraper-studio/complete-examples"},{"title":"Fix scrapers with the Self-Healing tool","sidebarTitle":"Self-Healing tool","tag":"New","mode":"wide","href":"/products/scraper-studio/self-healing-tool"},{"title":"Scraper Studio Auto Self-Healing","sidebarTitle":"Auto Self-Healing","href":"/products/scraper-studio/auto-self-healing"},{"title":"WARC snapshots in Scraper Studio","sidebarTitle":"WARC snapshots","href":"/products/scraper-studio/warc-ide"},{"title":"Scraper Studio IDE best practices","sidebarTitle":"Best practices","href":"/products/scraper-studio/best-practices"}]},{"group":"Run \u0026 deliver","pages":[{"title":"Initiate collection and delivery","sidebarTitle":"Initiate \u0026 delivery","href":"/products/scraper-studio/initiate-collection-and-delivery-options"},{"title":"Choose a delivery type on request level","sidebarTitle":"Delivery type","href":"/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level"},{"title":"Scraper Studio dashboard features","sidebarTitle":"Dashboard features","href":"/products/scraper-studio/features"}]},{"title":"Scraper Studio specifications","sidebarTitle":"Specifications","href":"/products/scraper-studio/specifications"},{"title":"Scraper Studio error codes","sidebarTitle":"Error codes","href":"/products/scraper-studio/error-codes"},{"title":"Scraper Studio video tutorials","sidebarTitle":"Video tutorials","href":"/products/scraper-studio/videos"},{"title":"Scraper Studio FAQs","sidebarTitle":"FAQs","href":"/products/scraper-studio/faqs"}]},{"group":"Dataset","pages":[{"group":"Dataset Marketplace","pages":[{"title":"Dataset view","href":"/products/marketplace/dataset-view"},{"title":"Customization and filtering","sidebarTitle":"Customize and filter","href":"/products/marketplace/customization-and-filtering"},{"title":"Marketplace fill rates","sidebarTitle":"Fill rates and statistics","href":"/products/marketplace/fill-rates-and-statistics"},{"title":"Purchase options","href":"/products/marketplace/purchase-options"},{"title":"Pricing","href":"/products/marketplace/pricing"},{"title":"Marketplace data delivery","sidebarTitle":"Data delivery and export","href":"/products/marketplace/data-delivery-and-export"},{"title":"Dataset marketplace FAQs","sidebarTitle":"FAQs","href":"/products/marketplace/faqs"},{"title":"Snowflake delivery configuration guide","sidebarTitle":"Snowflake","href":"/general/cloud-providers/snowflake"}]},{"group":"Dataset API","pages":[{"title":"Dataset API: search and filter","sidebarTitle":"Dataset API overview","href":"/api-reference/marketplace-dataset-api/overview"},{"title":"Filter dataset by API","url":"/api-reference/marketplace-dataset-api/filter-dataset","href":"/products/marketplace/filter-dataset-by-api"},{"title":"Search dataset (sync, Elasticsearch)","sidebarTitle":"Search dataset","href":"/api-reference/marketplace-dataset-api/search-dataset"},{"title":"Dataset API filter syntax","sidebarTitle":"Filter syntax","description":"Reference for the Bright Data Dataset API filter object: operators, filter groups, up to 3 levels of nesting and CSV/JSON file references.","href":"/api-reference/marketplace-dataset-api/filter-syntax"},{"title":"Troubleshooting","icon":"circle-exclamation","mode":"wide","href":"/api-reference/marketplace-dataset-api/troubleshooting"}]}]},{"group":"Web Unlocker API","pages":[{"title":"Web Unlocker API overview","description":"Bright Data Web Unlocker API (98% success rate) handles proxy rotation, anti-bot challenges and CAPTCHA solving in 1 call. Returns clean HTML or JSON.","sidebarTitle":"Introduction","href":"/products/web-unlocker/introduction"},{"title":"Create your first Web Unlocker API","sidebarTitle":"Quick Start","mode":"wide","href":"/products/web-unlocker/quickstart"},{"title":"Send your first Web Unlocker API request","sidebarTitle":"Send Your First Request","href":"/products/web-unlocker/send-your-first-request"},{"title":"Set up webhooks for Web Unlocker API","sidebarTitle":"Webhooks Setup","mode":"wide","href":"/products/web-unlocker/setup-webhooks"},{"title":"How to target API endpoints","sidebarTitle":"Target API endpoints","href":"/products/web-unlocker/target-api-endpoints"},{"title":"Web Unlocker API configuration","sidebarTitle":"Configuration","href":"/products/web-unlocker/configuration"},{"title":"Web Unlocker API features","sidebarTitle":"Features","href":"/products/web-unlocker/features"},{"title":"Web Unlocker API error codes","sidebarTitle":"Error codes","href":"/products/web-unlocker/error-codes"}]},{"group":"Browser API","pages":[{"title":"Introduction to Bright Data’s Browser API","sidebarTitle":"Introduction","href":"/products/scraping-browser/introduction"},{"title":"Create your first Browser API","sidebarTitle":"Quick Start","mode":"wide","href":"/products/scraping-browser/quickstart"},{"title":"Run your first browser session","sidebarTitle":"5 Minute How-To","href":"/products/scraping-browser/five-minute-how-to"},{"title":"Browser API code examples","sidebarTitle":"Code Examples","href":"/products/scraping-browser/code-examples"},{"title":"How to configure the Browser API","sidebarTitle":"Configuration","href":"/products/scraping-browser/configuration"},{"group":"Features","pages":[{"title":"Disable CAPTCHA solver","sidebarTitle":"Captcha Solver","href":"/products/scraping-browser/features/captcha-solver"},{"title":"Browser API geolocation targeting","sidebarTitle":"Geolocation targeting","href":"/products/scraping-browser/features/proxy-location"},{"title":"Browser API playground","sidebarTitle":"Playground","href":"/products/scraping-browser/features/playground"},{"title":"Browser API: premium domains","sidebarTitle":"Premium Domains","href":"/products/scraping-browser/features/premium-domains"},{"title":"Browser API troubleshooting","sidebarTitle":"Troubleshooting","href":"/products/scraping-browser/features/troubleshooting"}]},{"group":"CDP Functions","pages":[{"title":"Standard CDP functions","sidebarTitle":"Standard","href":"/products/scraping-browser/cdp-functions/standard"},{"title":"Custom CDP functions","sidebarTitle":"Custom","href":"/products/scraping-browser/cdp-functions/custom"}]},{"title":"Browser API error codes","sidebarTitle":"Error codes","href":"/products/scraping-browser/error-codes"},{"title":"Understanding your bandwidth","sidebarTitle":"Bandwidth","href":"/products/scraping-browser/bandwidth"},{"title":"Browser API FAQs","sidebarTitle":"FAQs","href":"/products/scraping-browser/faqs"}]},{"group":"SERP API","pages":[{"title":"Introduction to SERP API","sidebarTitle":"Introduction","href":"/products/serp-api/introduction"},{"title":"Create your first SERP API","sidebarTitle":"Quick Start","mode":"wide","href":"/products/serp-api/quickstart"},{"title":"Send your first SERP API request","sidebarTitle":"Send Your First Request","href":"/products/serp-api/send-your-first-request"},{"title":"SERP API async requests","sidebarTitle":"Asynchronous Requests","href":"/products/serp-api/asynchronous-requests"},{"title":"Get top 100 Google results","sidebarTitle":"Top 100 Google Results","href":"/products/serp-api/get-top-100-google-results"},{"group":"Guides","pages":[{"title":"Get started with Google SERP API","sidebarTitle":"Google SERP API","href":"/products/serp-api/get-started-google-serp-api"},{"title":"Get started with Bing SERP API","sidebarTitle":"Bing SERP API","href":"/products/serp-api/get-started-bing-serp-api"},{"title":"Guidelines for getting more Google ads","href":"/products/serp-api/guidelines-for-getting-more-google-ads"},{"title":"Bing to Bright Data SERP migration guide","sidebarTitle":"Bing to Bright Data SERP migration guide","href":"/products/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide"}]},{"group":"Fast SERP","pages":[{"title":"Fast SERP quickstart","sidebarTitle":"Quickstart","href":"/products/serp-api/fast-serp/quickstart"},{"title":"Fast SERP web search","sidebarTitle":"Web search","href":"/products/serp-api/fast-serp/web-search"},{"title":"Fast SERP news search","sidebarTitle":"News search","href":"/products/serp-api/fast-serp/news-search"},{"title":"Fast SERP shopping search","sidebarTitle":"Shopping search","href":"/products/serp-api/fast-serp/shopping-search"},{"title":"Fast SERP maps search","sidebarTitle":"Maps search","href":"/products/serp-api/fast-serp/maps-search"},{"title":"Fast SERP images search","sidebarTitle":"Images search","href":"/products/serp-api/fast-serp/images-search"}]},{"title":"SERP API configuration","sidebarTitle":"Configuration","href":"/products/serp-api/configuration"},{"group":"Query Parameters","pages":[{"title":"SERP API Google query parameters","sidebarTitle":"Google","href":"/products/serp-api/query-parameters/google"},{"title":"SERP API Bing query parameters","sidebarTitle":"Bing","href":"/products/serp-api/query-parameters/bing"},{"title":"SERP API Yandex query parameters","sidebarTitle":"Yandex","href":"/products/serp-api/query-parameters/yandex"},{"title":"SERP API DuckDuckGo query parameters","sidebarTitle":"DuckDuckGo","href":"/products/serp-api/query-parameters/duckduckgo"}]},{"title":"Google SERP features","sidebarTitle":"Features","href":"/products/serp-api/features"},{"title":"Parsed JSON results with SERP API","sidebarTitle":"Parsed JSON Results","href":"/products/serp-api/parsed-json-results"},{"title":"SERP pricing \u0026 billing","sidebarTitle":"Pricing \u0026 Billing","href":"/products/serp-api/pricing-and-billing"},{"title":"SERP troubleshooting","sidebarTitle":"Troubleshooting","href":"/products/serp-api/debugging"},{"title":"SERP API FAQs","sidebarTitle":"FAQs","href":"/products/serp-api/faqs"}]}]},{"group":"Web search","pages":[{"group":"Business Search","pages":[{"title":"What is Business Search?","sidebarTitle":"Introduction","href":"/products/business-search/introduction"},{"title":"Business Search quickstart","sidebarTitle":"Quickstart","href":"/products/business-search/quickstart"},{"title":"Company search","sidebarTitle":"Company search","href":"/products/business-search/company-search"},{"title":"People search","sidebarTitle":"People search","href":"/products/business-search/people-search"},{"title":"Business Search query syntax","sidebarTitle":"Query syntax","href":"/products/business-search/query-syntax"},{"title":"Business Search query examples","sidebarTitle":"Examples","href":"/products/business-search/examples"},{"title":"Business Search field views","sidebarTitle":"Field views","href":"/products/business-search/select-fields"},{"title":"How to paginate Business Search results","sidebarTitle":"Pagination","href":"/products/business-search/pagination"},{"title":"Business Search pricing","sidebarTitle":"Pricing","href":"/products/business-search/pricing"},{"title":"Business Search error codes","sidebarTitle":"Error codes","href":"/products/business-search/error-codes"}]}]},{"group":"AI training data","pages":[{"group":"Web Archive","pages":[{"title":"Web Archive overview","sidebarTitle":"Overview","href":"/products/archive/overview"},{"title":"Web Archive API","icon":"arrow-up-right-from-square","url":"/api-reference/archive-api/run-a-search","href":"/products/archive/api-reference"},{"title":"How data range affects delivery time","sidebarTitle":"Data Range vs. Delivery Time","href":"/products/archive/data-range-vs-delivery-time"},{"title":"FAQ: Archive API","sidebarTitle":"FAQs","href":"/products/archive/faqs"}]},{"title":"Media Data API","icon":"arrow-up-right-from-square","url":"/api-reference/media-data-api/media-data-api","href":"/datasets/media-data-api"}]},{"group":"Proxy networks","pages":[{"group":"Residential proxies","pages":[{"title":"Introduction to Residential proxies","sidebarTitle":"Introduction","href":"/products/residential/introduction"},{"title":"Create your first Residential proxy","sidebarTitle":"Quick Start","mode":"wide","href":"/products/residential/quickstart"},{"title":"How to configure your Residential proxy","sidebarTitle":"Configure","href":"/products/residential/configure-your-proxy"},{"title":"Residential network access policy","sidebarTitle":"Access Policy","href":"/products/residential/network-access"},{"title":"Send your first Residential proxy request","sidebarTitle":"Send your first request","href":"/products/residential/send-your-first-request"},{"title":"Residential products FAQ","sidebarTitle":"FAQs","href":"/products/residential/faqs"},{"title":"How consumers join the peers network","sidebarTitle":"Bright Data Peers Network","href":"/general/policy/How_do_consumers_join_the_Bright_Data_network_of_peers_"}]},{"group":"ISP proxies","pages":[{"title":"Introduction to ISP proxies","sidebarTitle":"Introduction","href":"/products/isp/introduction"},{"title":"Create your first ISP proxy","sidebarTitle":"Quick Start","mode":"wide","href":"/products/isp/quickstart"},{"title":"How to configure your ISP proxy","sidebarTitle":"Configure","href":"/products/isp/configure-your-proxy"},{"title":"Send your first ISP proxy request","sidebarTitle":"Send your first request","href":"/products/isp/send-your-first-request"},{"title":"ISP proxies FAQs","sidebarTitle":"FAQs","href":"/products/isp/faqs"}]},{"group":"Datacenter proxies","pages":[{"title":"Introduction to Datacenter proxies","sidebarTitle":"Introduction","href":"/products/data-center/introduction"},{"title":"Create your first Datacenter proxy","sidebarTitle":"Quick Start","mode":"wide","href":"/products/data-center/quickstart"},{"title":"How to configure your Datacenter proxy","sidebarTitle":"Configure","href":"/products/data-center/configure-your-proxy"},{"title":"Send your first Datacenter proxy request","sidebarTitle":"Send your first request","href":"/products/data-center/send-your-first-request"},{"title":"Datacenter proxy FAQ","sidebarTitle":"FAQs","href":"/products/data-center/faqs"}]},{"group":"Proxy Manager","pages":[{"title":"Introduction to Proxy Manager","sidebarTitle":"Introduction","href":"/products/proxy-manager/introduction"},{"title":"Create your first Proxy Manager","sidebarTitle":"Quick Start","mode":"wide","href":"/products/proxy-manager/quickstart"},{"title":"How to configure the Proxy Manager","sidebarTitle":"Configure","href":"/products/proxy-manager/configuration"},{"title":"Proxy Manager integration","sidebarTitle":"Integration","href":"/products/proxy-manager/integration"},{"title":"Secure your Proxy Manager setup","sidebarTitle":"Security","href":"/products/proxy-manager/security"},{"title":"Proxy Manager SSL analysis CA migration","sidebarTitle":"Certificate migration","href":"/products/proxy-manager/certificate-migration"},{"title":"Proxy Manager FAQs","sidebarTitle":"FAQs","href":"/products/proxy-manager/faqs"}]},{"group":"Browser Extension","pages":[{"title":"Introduction","href":"/products/browser-extension/introduction"},{"title":"How to install the extension","href":"/products/browser-extension/install"},{"title":"Getting started with Browser extension","sidebarTitle":"Quick Start","href":"/products/browser-extension/quickstart"},{"title":"Browser extension configuration","href":"/products/browser-extension/configuration"},{"title":"Browser extension features","href":"/products/browser-extension/features"},{"title":"Browser extension FAQs","sidebarTitle":"FAQs","href":"/products/browser-extension/faqs"}]},{"group":"Reference","pages":[{"title":"Proxy configuration options","sidebarTitle":"Config Options","href":"/proxy-networks/config-options"},{"title":"SOCKS and SOCKS5 proxies","sidebarTitle":"SOCKS5 Proxies","href":"/proxy-networks/socks5"},{"title":"Proxy errors troubleshooting","sidebarTitle":"Error Catalog","href":"/proxy-networks/errorCatalog"},{"title":"Overcoming website blocking","sidebarTitle":"Website Blocking","href":"/proxy-networks/website-blocking"},{"title":"Why your DNS shows a different country","sidebarTitle":"DNS Location Mismatch","href":"/proxy-networks/dns-location-mismatch"},{"title":"Proxy products FAQ","href":"/proxy-networks/faqs"}]}]},{"group":"Managed services","pages":[{"title":"Bright Data Managed Services overview","sidebarTitle":"Overview","href":"/products/managed-services/overview"},{"title":"How Bright Data Managed Services works","sidebarTitle":"How it works","href":"/products/managed-services/how-it-works"},{"title":"Bright Data Managed Services FAQs","sidebarTitle":"FAQs","href":"/products/managed-services/faqs"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/authentication"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/introduction"}]},{"tab":"Account Management","pages":[{"title":"Account Management","href":"/general/account/overview"}]},{"tab":"Left over","hidden":true,"pages":[{"title":"Left over","href":"/left-over/datasets-introduction"}]}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/api-reference/marketplace-dataset-api/troubleshooting"}]}]},"basePath":"","title":"Troubleshooting - Bright Data Docs","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}