> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supadata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Forbidden

> Access to this resource is forbidden. Explanation of the error and how to fix it.

Access to this resource is forbidden. This error occurs when the content you requested exists but cannot be accessed: it is private, restricted, geo-blocked, or the server hosting a media file refused the request.

```json theme={null}
{
  "error": "forbidden",
  "message": "Forbidden",
  "details": "Access to this resource is forbidden",
  "documentationUrl": "https://docs.supadata.ai/errors/forbidden"
}
```

<Info>
  When an asynchronous job fails with this error, the job status endpoint returns `"status": "failed"` with the error object nested under an `error` field.
</Info>

## Reasons and how to fix

### Private or restricted social media content

Social media platforms like YouTube, TikTok, Instagram, X (Twitter) and Facebook may restrict access to certain content. Common scenarios include private videos, members-only or subscriber-only content, age-restricted videos, videos that require signing in, and heavily geo-blocked content.

To fix this:

1. Verify the content is publicly accessible without login
2. Ensure the content isn't set to private, unlisted, or members-only
3. Test the link in a private/incognito browser window — if you can watch it there, Supadata can access it
4. If possible, download the media and host it on publicly accessible storage

### Geo-blocked content

Some videos are only available in specific countries. If the content is blocked in the regions Supadata operates from, the request returns `forbidden`.

To fix this, use a different source for the content or host a copy on publicly accessible storage.

### Cloud storage permissions (403 from origin)

When `url` is a file URL, this error means the server hosting the file responded with HTTP 403. Your media might be hosted on S3 or another cloud storage service with restrictive permissions that prevent our servers from accessing it.

To fix this:

1. Ensure your storage bucket allows public read access
2. Update IAM policies to allow external access to the specific media files
3. Test URL accessibility from a different network or device to confirm it's publicly accessible

<Note>
  Pre-signed URLs whose expiry time has already passed are rejected before any download attempt with an [`invalid-request`](/errors/invalid-request) error, not `forbidden`.
</Note>

### Reach out to support

If you continue to face issues or need further assistance, please reach out to [support@supadata.ai](mailto:support@supadata.ai), and we will assist you as soon as possible.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.