Zyte Api

Monitors Zyte API service health and incident reports to automatically pause scraping workflows during outages and notify engineering teams of maintenance windows.

Try Zyte Api in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Zyte Api integration

    • Describe the outcome and Ceven picks the right Zyte Api calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Zyte Api data, across all 7 of its actions.
  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Zyte Api access.
    • Per user and per environment credentials instead of shared keys.
  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Zyte Api, when, and on whose behalf.
    • The agent pauses and asks when Zyte Api is unclear instead of plowing ahead.
  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Zyte Api.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Zyte Api action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Zyte Api, and when to use it.

Fetch active maintenances
Use this when you need to know ongoing maintenance events currently affecting the API.
Get scheduled maintenances
Pull the 50 most recent scheduled maintenances, including upcoming and completed events, for monitoring.
Get unresolved incidents
Use this when you need to check currently open incidents that might be causing request failures.
List status incidents
Pull the 50 most recent incidents from the status page to analyze historical API health trends.
Get status summary
Use this when you need a high level overview of status indicators, components, and open incidents.
Get upcoming maintenances
Retrieve future scheduled maintenance windows to plan scraping job offsets.
Fetch API components
Pull a current snapshot of individual service component health and their operational states.
Get status rollup
Use this when you need a current summary of overall service health before starting a large crawl.
Fetch Active Scheduled Maintenances
Tool to fetch currently active scheduled maintenances. use when you need to know ongoing maintenance events.
Zyte API: Get Unresolved Incidents
Tool to retrieve unresolved incidents from zyte status api. use when you need to check currently open incidents.
List Zyte API status incidents
Tool to list the 50 most recent incidents on the zyte api status page. use after needing current api health or incident summaries.
Zyte Status Summary
Tool to get a summary of status indicators, component statuses, unresolved incidents, and scheduled maintenances. use when you need an overview of the current zyte service health.
Upcoming Scheduled Maintenances
Tool to retrieve upcoming scheduled maintenance windows. use when you need to list upcoming maintenance events from the zyte api status page.
Zyte API Components
Tool to fetch the list of zyte api service components and their statuses. use when you need a current snapshot of component health from the zyte status page.
Get Zyte API Status Rollup
Tool to retrieve the overall status rollup for the zyte api. use when you need a current summary of service health before proceeding.

15 actions · scroll to see them all

Frequently asked questions

Ceven monitors the status rollup and unresolved incident endpoints in real time. When the agent detects a status change from operational to degraded or down, it can trigger a predefined workflow. This usually involves pausing any active scraping jobs to avoid wasting credits on requests that will fail. The agent then sends a notification to your team with the specific component that is failing. Once the Zyte API status returns to operational, the agent can automatically resume the paused jobs. This prevents your data pipelines from filling with error logs and ensures that your team is only alerted when a human needs to intervene in the extraction process.
Ceven cannot predict unplanned outages, but it can track all scheduled maintenances. By pulling the upcoming maintenance windows, the agent adds these time blocks to your internal calendar or job scheduler. If a high volume crawl is scheduled during a maintenance window, the agent can suggest a new time or automatically shift the start time to a window where the API is confirmed to be operational. This proactive approach reduces the number of failed requests and ensures that your data delivery SLAs are met without manual oversight of the Zyte status page.
Incidents are unplanned events, such as a sudden outage or a performance degradation, that affect the API availability. Maintenance events are planned windows where Zyte performs updates or upgrades. Ceven treats these differently in the workflow layer. Incidents usually trigger immediate alerts and emergency pauses of all data flows. Maintenance events trigger scheduling adjustments and warnings sent to the team a few days in advance. By distinguishing between these two, the agent ensures that your team is not woken up at midnight for a planned update but is immediately notified if a critical service component goes offline unexpectedly.
Yes, Ceven can fetch the status for all individual service components listed in the Zyte API status page. This is useful because some parts of the platform might be operational while others are experiencing issues. For example, the basic extraction might work while a specific advanced feature is down. The agent can check the component health specifically for the features your workflow uses. If only a non critical component is degraded, the agent can allow the workflow to continue while logging a warning, rather than stopping the entire data pipeline for a minor issue.
Ceven is limited by the data provided by the Zyte status API. One specific quirk is that the incident and maintenance lists are capped at the 50 most recent events. If you need to perform a long term reliability analysis over several years, the agent cannot pull that history in a single call because the API does not provide a full historical archive beyond that limit. For most operational needs, this is sufficient, but for deep auditing, you would need to have Ceven archive the status updates into your own database on a daily basis.
The frequency depends on how you configure your workflow. You can set the agent to poll the status rollup every minute for critical pipelines or once an hour for less urgent tasks. Because these are read only calls to a status endpoint, they do not count against your primary scraping credits. We recommend a five minute interval for most users, which provides a good balance between fast reaction times and reducing unnecessary API chatter. The agent can also be configured to poll more frequently if it detects a transition from operational to a warning state.
Ceven cannot directly open a ticket inside the Zyte internal support system as there is no public write API for ticket creation. However, the agent can automate the preparation of the ticket. When an incident is detected, Ceven can gather the exact component name, the time the failure started, and the specific request IDs that failed. It can then draft an email or a support request in your ticketing system with all this technical data attached, so your team only has to click send to notify Zyte support of the impact on your account.
The integration uses secure connection protocols to communicate with the Zyte status endpoints. Since the status API provides public health data, the risk is minimal, but Ceven still ensures that all communication is encrypted in transit. Your account credentials for the broader Zyte platform are stored encrypted at rest and are never exposed to the model or the workflow author. The agent only accesses the specific endpoints required to monitor health and manage the status of your extraction jobs, adhering to the principle of least privilege for all automated actions.

Alternatives to Zyte Api

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Zyte Api and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free