import.io APIs for AI Agents
Data EnrichmentData TransformationOfficial Vendor SpecsAPI keyAgent Ready
For Agents
APIs5 in catalogue
Endpoints10 indexed
AuthAPI key — 1 credential for all 5 APIs
ProvenanceOfficial OpenAPI specs
An agent can drive an import.io extractor end to end: start or cancel crawl runs, run adhoc extractions for the freshest data, schedule recurring runs, watch a run feed for completion, and fetch the latest results as CSV or JSON. This lets an agent automate web data collection and hand structured rows to downstream tools without writing per-endpoint code.
import.io splits the scrape lifecycle into small, single-purpose APIs (schedule, run, extraction, data, rss) that each target a dedicated host, so an agent can trigger, monitor, and read from a configured extractor as separate scoped operations rather than one monolithic scraping call.
Use for: Automating the crawl lifecycle of pre-configured import.io extractors: scheduling, running, monitoring, and reading structured web-scraped results as CSV or JSON.
Not supported: extractor authoring, arbitrary URL scraping, webhook notifications, run result webhooks, data transformation
Credentials: All five import.io APIs authenticate the same way, with an apikey query parameter, so one account key covers every surface.
All 5 import.io OpenAPI specs are vendor-official and indexed by Jentic, kept validated and agent-ready.
import.io is a web data extraction platform that turns configured extractors into structured datasets. Its APIs cover the full crawl lifecycle for an extractor: schedule recurring runs, launch or cancel runs on demand, run one-off adhoc extractions inline, read the latest crawl results as CSV or JSON, and monitor run history through a feed. Together they let pipelines and agents automate scraping of target web pages and pull the resulting rows into downstream systems.
import.io API Catalog
5 APIs across 1 product group. All share one credential.
Data Enrichment5
import.io Schedule APIManage recurring crawl schedules for import.io extractors.~4 endpointsimport.io Data APIFetch the latest crawl results from an import.io extractor as CSV or JSON.~2 endpointsimport.io Run APIStart and cancel crawl runs for an import.io extractor.~2 endpointsimport.io Extraction APIRun an adhoc extraction against an import.io extractor and receive the result inline.~1 endpointimport.io RSS APIRead a feed of recent crawl runs for a specific import.io extractor.~1 endpoint
Which import.io API should I use?
| I want to... | Use | Why |
|---|---|---|
| Get fresh structured data from an extractor right now | import.io Extraction API | Runs the extractor inline and returns rows in a single call, without scheduling or reading stored output. |
| Read the most recent crawl output without re-running | import.io Data API | Returns the latest stored run results as CSV or JSON, cheaper than triggering a live extraction. |
| Trigger or stop a crawl run on demand | import.io Run API | Starts and cancels individual runs; results are read later via the Data API. |
| Automate a run on a fixed cadence | import.io Schedule API | Creates, lists, retrieves, and deletes recurring schedules so runs fire without manual triggers. |
| Detect when a run completes | import.io RSS API | Exposes a feed of recent runs for monitoring and triggers, avoiding polling the Run or Data APIs. |
Install Jentic One Beta
Connect the import.io APIs to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the import.io APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fimport.io" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fimport.io" | 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.
Once connected, ask your agent something like: “automate an import.io extractor: schedule, run, and fetch results”.
What AI Agents Can Do with import.io
Each workflow spans multiple import.io APIs. Jentic routes each operation to the right API automatically.
On-demand pipeline refresh
An agent starts a crawl for a saved extractor, waits for the run to appear in the run feed, then fetches the refreshed rows for downstream loading. This drives freshness on demand without relying on the platform's own schedules.
Example prompt:
Start extractor ext-prices, poll the run feed until the new run appears, then fetch the latest JSON results and report the row count.
APIs used
import.io Run API + import.io RSS API + import.io Data API
Scheduled collection with completion monitoring
An agent schedules an extractor to run daily and watches the run feed to confirm each scheduled run finished before reading the latest output for reporting.
Example prompt:
Schedule extractor ext-competitor-prices for 06:00 UTC daily, then each morning confirm the run in the feed and fetch the latest CSV.
APIs used
import.io Schedule API + import.io RSS API + import.io Data API
Freshness fallback for reads
An agent tries the cheap stored-results read first; if the latest run is stale it runs an adhoc extraction inline to get up-to-the-minute rows.
Example prompt:
Fetch the latest JSON for extractor ext-news; if the newest run is older than one hour, run an adhoc extraction instead and return those rows.
APIs used
import.io Data API + import.io Extraction API
Schedule cleanup with manual triggering
An agent decommissions a recurring schedule and switches an extractor to on-demand triggering, then verifies runs still fire manually.
Example prompt:
Delete the schedule on extractor ext-old-feed, confirm it no longer lists, then start a one-off run to verify manual triggering works.
APIs used
import.io Schedule API + import.io Run API
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring import.io by hand means passing your apikey as a query parameter against five separate hosts (schedule, run, extraction, data, and rss) and shaping each request yourself. Through Jentic you install once, import the import.io APIs you need from the Jentic API Directory, store the apikey once, and your agent calls them.
Permission scoping
The import.io surfaces range from read-only reads and feeds to run triggers and schedule deletes. Because your own rules choose which operations an agent may call, you can allow it to read results and monitor runs while withholding operations that start crawls or delete schedules.
Credential isolation
Your import.io apikey is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context, and one key covers all five APIs.
Intent-based discovery
Agents search Jentic by intent such as 'schedule an extractor' or 'fetch the latest extractor results', and Jentic returns the matching import.io operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
FAQs
Specific to using import.io APIs through Jentic.
What can an agent do across the import.io APIs?
An agent can manage the full lifecycle of a configured extractor: schedule recurring runs, start or cancel runs on demand, run one-off adhoc extractions, monitor run history through a feed, and read the latest results as CSV or JSON.
Do the import.io APIs share one credential?
Yes. Every surface authenticates with the same apikey query parameter, so a single import.io account key works across the Schedule, Run, Extraction, Data, and RSS APIs.
What is the difference between the Extraction API and the Data API?
Extraction runs the extractor live and returns rows inline, which is best when freshness matters. Data reads the latest stored crawl output as CSV or JSON, which is cheaper and faster when a recent run already exists.
How do these APIs fit together into a scrape pipeline?
Schedule or Run starts work, RSS reports when a run completes, and Data exposes the resulting rows. Chaining them lets an agent trigger, watch, and read a crawl without manual steps.
Can these APIs scrape any URL or build new extractors?
No. They operate on extractors that are already configured in import.io. There is no operation to author an extractor or scrape an arbitrary URL that has no extractor defined for it.
How does an agent pick the right import.io API for a task?
Use Run or Schedule to trigger crawls, RSS to detect completion, Extraction for immediate inline results, and Data to read the most recent stored output. Through Jentic the agent searches by intent and gets the matching operation and its schema.
If you need a different Data Enrichment vendor
All 3 are in the Jentic catalogue with the same one-credential, intent-search pattern.
BOOK A DEMO
Start Connecting APIs to Your AI Agents
Browse thousands of APIs and connect them all to your agent with Jentic One. One layer, one credential — every API your agent needs.