Analyze a public web page against developer-defined safety categories. Receive the detected category and an explanation for content filtering, compliance, and review.
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Website Safety Classification API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
(Save 2 months with annual billing 🎉)
Classify public web pages for adult, gambling, violent, hateful, drug-related, or other unsafe content. Returns the detected category, an explanation, and usage details.
The API analyzes the textual content of a public web page and selects the best matching category from the safety categories supplied in the request.
Send the public page URL together with categories such as safe, adult content, gambling, violence, hate speech, drugs, or weapons.
Yes. Provide your own categories array with the labels relevant to your application. The API returns the category that best matches the analyzed content.
Yes. You can supply text instead of a URL to classify comments, articles, descriptions, messages, or other textual content.
No. Each request analyzes one public web page. To check multiple pages, send a separate request for each URL.
The current classification is based on text extracted from the page. It does not directly inspect the visual content of images or videos.
No automated classification is perfect. Use the result as a safety signal and consider additional review for moderation, legal, or other high-impact decisions.
The API returns the detected category and a short explanation of why the analyzed content matches that category.
The endpoint returns a JSON object containing the analysis result, including the detected category, a reason for the classification, token usage details, and processing time.
Key fields include "success" (boolean), "url" (the analyzed URL), "data" (containing "category" and "reason"), "usage" (input and output token counts), and "processing_ms" (time taken for analysis).
The response is structured as a JSON object with a top-level success indicator, followed by the analyzed URL, a data object for classification details, a usage object for token counts, and processing time in milliseconds.
The endpoint provides information on the safety category of the analyzed web page, an explanation for the classification, and usage statistics related to token consumption.
Users can customize requests by providing their own array of safety categories in the API call, allowing for tailored classifications based on specific needs.
Typical use cases include content moderation for websites, compliance checks for online platforms, and filtering unsafe content in applications or services.
Users can leverage the "category" field to determine content safety and the "reason" field to understand the classification rationale, aiding in moderation and compliance decisions.
Data accuracy is maintained through continuous updates and improvements to the classification algorithms, ensuring that the API adapts to evolving content standards and safety categories.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
