For Agents
Manage recurring crawl schedules for import.io extractors. Useful for automating periodic data collection without manual run triggers.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the import.io Schedule API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with import.io Schedule API API.
List schedules across all extractors in an account
Schedule an extractor to run at a specific time or cadence
Retrieve the schedule for one extractor
Delete an existing schedule from an extractor
GET STARTED
Use for: I want to schedule an extractor to run daily, List all current extractor schedules on my account, Get the schedule attached to a specific extractor, Delete the schedule on an extractor
Not supported: Does not run crawls inline, return result rows, or build extractors - use for managing recurring extractor schedules only.
The import.io Schedule API manages recurring crawl schedules for extractors. Four endpoints cover listing all schedules across the account, scheduling an extractor to run at a specific time, retrieving the schedule for one extractor, and deleting an existing schedule. Authentication uses an apikey query parameter. Pair Schedule with the Run, Data, and RSS APIs to build automated, recurring scrape pipelines.
Coordinate recurring scrapes with downstream pipelines
Patterns agents use import.io Schedule API API for, with concrete tasks.
★ Recurring Data Collection
Set up regular scrape cadences for extractors that feed dashboards, alerting, or BI. Use POST /extractor to schedule an extractor at a specific time and GET /extractor to confirm the schedule is in place. The schedule then triggers crawl runs without manual intervention.
Schedule extractor ext-prices to run every day at 06:00 UTC and confirm the schedule shows up in GET /extractor.
Schedule Audit Across Account
Operations teams can list every active schedule on the account using GET /extractor. The list view makes it straightforward to see which extractors are scheduled, when they run, and which extractors are still on manual triggering.
List all extractor schedules and report any extractor missing a schedule from the expected list.
Schedule Cleanup
Decommissioning an extractor or moving to on-demand triggering means deleting the existing schedule. DELETE /extractor/{extractorId}/ removes the schedule cleanly so the extractor only runs when explicitly invoked through the Run API.
Delete the schedule on extractor ext-old-feed and confirm the schedule no longer appears in GET /extractor.
Jentic-Driven Schedule Manager
Through Jentic, an agent can manage extractor schedules from a chat surface. The agent searches for a schedule operation, loads the schema, and creates, retrieves, or deletes schedules without learning the endpoint paths.
Search Jentic for 'schedule an extractor to run', load the schema, and create a daily 09:00 UTC schedule for extractor ext-jobs.
4 endpoints — the import.
METHOD
PATH
DESCRIPTION
/extractor
List schedules for all extractors
/extractor
Schedule an extractor to run at a specific time
/extractor/{extractorId}/
Get the schedule for one extractor
/extractor/{extractorId}/
Delete an existing schedule
/extractor
List schedules for all extractors
/extractor
Schedule an extractor to run at a specific time
/extractor/{extractorId}/
Get the schedule for one extractor
/extractor/{extractorId}/
Delete an existing schedule
Three things that make agents converge on Jentic-routed access.
Credential isolation
import.io apikey query parameters are stored encrypted in the Jentic vault. Agents call the Schedule API with a scoped Jentic token and the raw apikey never enters agent prompts or logs.
Intent-based discovery
Agents search Jentic by intent such as 'schedule an extractor' or 'list extractor schedules' and Jentic returns the matching Schedule API operations with input schemas.
Time to first call
Direct import.io Schedule integration: a few hours to wire create, list, and delete flows. Through Jentic: under 30 minutes. Search, load, execute.
Alternatives and complements available in the Jentic catalogue.
import.io Run API
Triggers individual runs ad hoc, alongside scheduled runs
Use Schedule for recurring cadence and Run for one-off triggers between scheduled occurrences.
import.io RSS API
Reports run completion for scheduled and ad-hoc runs
Use RSS to detect when a scheduled run completes; this is the trigger for downstream Data API reads.
Apify
Scraping platform with native cron-style schedules and webhook delivery
Choose Apify when the agent needs richer scheduling expressions and webhook completion delivery.
Specific to using import.io Schedule API API through Jentic.
What authentication does the import.io Schedule API use?
The Schedule API uses an apikey query parameter on every request. Through Jentic, the apikey is stored in the encrypted vault and injected at runtime, so the raw key never enters agent prompts.
Can I list all schedules on my account?
Yes. GET /extractor returns the list of schedules for every extractor on the account, which is useful for auditing scrape cadence and spotting extractors that are still on manual triggering.
What are the rate limits for the import.io Schedule API?
The published spec does not declare explicit rate limit numbers. Schedule operations are infrequent by nature, so most agents stay well below import.io's per-account quotas regardless of plan tier.
How do I create a daily schedule for an extractor through Jentic?
Search Jentic for 'schedule an extractor to run' to find the operation backed by POST /extractor. Load the schema, pass the extractor id and desired time, and execute. Jentic injects the apikey at runtime.
How do I remove a schedule from an extractor?
Call DELETE /extractor/{extractorId}/ with the extractor id. The response confirms removal. The extractor will then only run when triggered manually via the Run API or rescheduled.