ceven

Smartproxy

Automates large scale web data extraction by rotating residential and mobile proxies to bypass blocks and feeds the raw HTML into your analysis pipeline.

Try Smartproxy in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Smartproxy integration

    • Describe the outcome and Ceven picks the right Smartproxy 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 Smartproxy data, across all 6 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Smartproxy 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 Smartproxy, when, and on whose behalf.
    • The agent pauses and asks when Smartproxy is unclear instead of plowing ahead.

  4. Enterprise grade security

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

Supported tools

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

Get API Key
Use this when you need to find the manual dashboard process to obtain a new API key for authentication.
List Endpoints
Pull the full inventory of available proxy endpoints and ports to configure a new crawl.
Rotate Residential IP
Request a new residential IP address to avoid rate limits or IP bans on a target site.
Fetch Page HTML
Pull the raw HTML of a specific URL using a designated proxy endpoint.
Set Proxy Region
Change the geographic location of the proxy to view site content as a user in a specific country.
Check Proxy Status
Verify if a specific proxy port is active and available for requests.
Get Data Usage
Pull current bandwidth consumption to monitor remaining proxy data limits.
Update Proxy User
Modify the authentication credentials for a specific proxy user account.
List Active Sessions
Pull a list of all current proxy sessions to identify hung requests.
Terminate Session
Force close a specific proxy session to free up a connection slot.
Get IP Details
Pull metadata for a specific IP including city and ISP provider.
Configure Header
Set custom HTTP headers to mimic a real browser during a Smartproxy request.
List Endpoints and Ports
Tool to retrieve all available proxy endpoints and corresponding ports. use when you need to fetch the full inventory of smartproxy endpoints.

13 actions · scroll to see them all

Frequently asked questions

Ceven manages the rotation logic automatically within the workflow. When the agent detects a 403 Forbidden or 429 Too Many Requests error from the target website, it triggers a rotation action to swap the current IP for a fresh one from the Smartproxy pool. You can set the rotation frequency to happen every request or after a specific number of successful pages. This ensures that your scraping tasks remain undetected and do not trigger security alerts on the destination server. The agent tracks which IPs have been used and manages the session persistence if you need to keep the same IP for a multi step checkout or login flow.
Yes. Ceven can instruct Smartproxy to route requests through specific countries or cities. This is useful for testing localized content or pricing. You simply specify the target country in the workflow prompt, and the agent selects the corresponding proxy endpoint. If the requested region is unavailable or exhausted, the agent can either fail the task or fallback to a secondary region that you define in the settings. This allows for precise geographic targeting across the entire residential network without manual configuration of the proxy strings for every single request.
Ceven stores your Smartproxy API keys using AES 256 encryption at rest. These keys are only decrypted in a secure execution environment at the moment the agent needs to make a request to the Smartproxy API. We do not expose these keys in the workflow logs or to other users of your workspace. You can rotate your keys in the Smartproxy dashboard and update them in the Ceven integration settings at any time. This architecture ensures that your proxy access remains secure while allowing the agent to operate on your behalf without manual login.
If you hit your data limit, Smartproxy will return a specific error code indicating that the balance is exhausted. Ceven catches this error and pauses the workflow immediately to prevent a loop of failed requests. The agent then sends a notification to the workspace owner via your preferred channel, such as Slack or email, alerting you that the proxy quota is empty. Once you top up your account in the Smartproxy dashboard, you can resume the workflow from the exact point where it stopped, ensuring no data gaps in your scraping project.
Concurrent request limits are determined by your specific Smartproxy plan tier rather than Ceven. For example, lower tiers have a cap on how many simultaneous connections can be open. If the agent attempts to launch more concurrent requests than your plan allows, Smartproxy will reject the connection. To handle this, Ceven implements a request queue that throttles the scraping speed to match your plan limits. You can adjust the concurrency settings in the agent configuration to optimize for speed or stability based on the restrictions of your current subscription level.
Ceven uses the built in capabilities of the Smartproxy scraping API to handle basic bot detection. When a CAPTCHA is encountered, the agent can attempt to use Smartproxy's automated solving features if they are enabled on your account. If the CAPTCHA is too complex for the automated system, the agent will flag the URL and move to the next item in the list, logging the failure. For high security sites, we recommend using a combination of residential proxies and slow request intervals to minimize the number of CAPTCHAs triggered during the data collection process.
The agent can switch between residential, mobile, and datacenter proxies based on the requirements of the task. If a site has extremely strict bot detection, the agent can be instructed to use mobile proxies, which have the highest trust score. Datacenter proxies are used for high speed tasks where detection is less of a concern. You define the priority of proxy types in your workflow, and Ceven handles the endpoint switching. This flexibility allows you to balance cost and success rates by using the cheapest proxy that gets the job done for each specific target site.
Yes, Ceven can maintain a sticky session through Smartproxy. This means the agent will use the same IP address for a sequence of requests, which is critical for tasks like scraping a paginated list or completing a multi page form where the server expects the user to stay on one IP. You can define the session duration in the workflow settings. Once the session expires or the task is complete, the agent releases the IP back into the pool. This prevents the site from seeing a single user jumping between different countries in a matter of seconds.

Alternatives to Smartproxy

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

Bright Data logoBright DataOxylabs logoOxylabsSmartproxy logoSmartproxy

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Smartproxy 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