When an asynchronous job fails with this error, the job status endpoint returns
"status": "failed" with the error object nested under an error field.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:- Verify the content is publicly accessible without login
- Ensure the content isn’t set to private, unlisted, or members-only
- Test the link in a private/incognito browser window — if you can watch it there, Supadata can access it
- 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 returnsforbidden.
To fix this, use a different source for the content or host a copy on publicly accessible storage.
Cloud storage permissions (403 from origin)
Whenurl 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:
- Ensure your storage bucket allows public read access
- Update IAM policies to allow external access to the specific media files
- Test URL accessibility from a different network or device to confirm it’s publicly accessible
Pre-signed URLs whose expiry time has already passed are rejected before any download attempt with an
invalid-request error, not forbidden.