Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the link.fish 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.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
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%2Flink.fish%2Flink-fish-api-main" | shStep 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%2Flink.fish%2Flink-fish-api-main" | 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 link.fish API.
Extract main content, title, and metadata from any web URL without writing scrapers
Generate full-page screenshots of a URL using a headless-browser renderer
Pull tabular data from HTML pages and return it as structured rows
Identify social-media accounts referenced on a target page across major networks
Resolve URL pages that link to mobile apps in the App Store and Google Play
GET STARTED
Geocode the location implied by a URL's content into latitude and longitude
Patterns agents use link.fish API for, with concrete tasks.
★ Link Preview Generation
Generate rich link previews for chat, email, or CMS clients by extracting title, image, and description plus a full-page screenshot. The /Urls/data and /Urls/browser-screenshot endpoints handle both fast extraction and rendered captures. Replaces hand-maintained Open Graph parsers with one call.
Extract metadata for URL 'https://example.com/article' and generate a 1200x630 screenshot for a chat link preview
Content Ingestion Pipeline
Ingest article content, tabular data, and metadata into a knowledge base from a list of URLs. The /Urls/browser-data endpoint renders JavaScript-driven pages so single-page-app content is captured correctly. Replaces custom Puppeteer pipelines for many simple use cases.
For each URL in a list of 50 industry blogs, run /Urls/browser-data and store the extracted article text
Social-Media Discovery
Find the social-media handles a brand or person publishes on their website without manually crawling each page. The /Urls/social-media endpoint returns Twitter, LinkedIn, Instagram, and other handles surfaced on a URL. Useful for outbound research and lead enrichment.
Run /Urls/social-media against 'https://acme.com' and return all extracted social handles
AI Agent Web Researcher
An AI agent uses Jentic to call link.fish operations when it needs structured page content, social handles, or screenshots from a URL. The agent composes /Urls/data and /Urls/browser-screenshot to surface page summaries with previews. Credentials stay isolated through Jentic.
Search Jentic for 'extract data from a URL', load /Urls/data, and call it with the user's target URL
8 endpoints — jentic publishes the only available openapi specification for link.
METHOD
PATH
DESCRIPTION
/Urls/data
Extract structured data from a URL
/Urls/browser-data
Extract data using a headless browser
/Urls/browser-screenshot
Generate a screenshot of a URL
/Urls/social-media
Get social-media accounts referenced on a URL
/Urls/data-tabular
Return tabular data extracted from a URL
/Urls/data
Extract structured data from a URL
/Urls/browser-data
Extract data using a headless browser
/Urls/browser-screenshot
Generate a screenshot of a URL
/Urls/social-media
Get social-media accounts referenced on a URL
/Urls/data-tabular
Return tabular data extracted from a URL
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the link.fish API by hand means setting its HTTP Basic credentials, learning which endpoints return page data, browser-rendered data, screenshots, and social metadata, and calling api.link.fish yourself. Through Jentic you install once, import the link.fish API from the API Directory, store the credentials once, and your agent calls it.
Permission scoping
link.fish passes the target URL as a query parameter rather than a resource id in the path, so scope the agent to the operations it needs, such as extracting data or capturing a screenshot from a single URL. You leave out operations you do not want it to run, so it only calls the ones you allow.
Credential isolation
Your link.fish username and password are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'extract data from a URL' or 'capture a screenshot of a page', and Jentic returns the matching link.fish operation with its query schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using link.fish API through Jentic.
Why is there no official OpenAPI spec for link.fish API?
link.fish does not publish a maintained OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the link.fish API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the link.fish API use?
link.fish uses HTTP Basic authentication with a username and password issued by the platform. All requests must use HTTPS. Through Jentic, the credentials are stored encrypted in your Jentic One instance and injected per request.
Can I extract data from JavaScript-rendered pages with link.fish?
Yes. Use /Urls/browser-data to render the page in a headless browser before extracting. /Urls/data is faster but only sees server-rendered HTML, so prefer /Urls/browser-data for single-page apps.
What are the rate limits for the link.fish API?
The spec does not document explicit rate limits. Treat browser-rendered endpoints as more expensive than plain extraction; back off on HTTP 429 and prefer /Urls/data over /Urls/browser-data when the target page is not JavaScript-driven.
How do I generate a webpage screenshot through Jentic?
Run pip install jentic, then search Jentic with 'generate a screenshot of a webpage' to retrieve /Urls/browser-screenshot. Execute it with the target URL; Jentic handles HTTP Basic credentials automatically.
Can link.fish extract tabular data from HTML?
Yes. /Urls/data-tabular returns tabular content from a URL as structured rows, suitable for ingesting reference tables and league standings without writing custom HTML parsers.
Can I limit what my agent is allowed to do with the link.fish API?
Yes. Jentic One is self-hosted by you, so your own rules decide which link.fish operations and credentials the agent may use. Because link.fish takes the target URL as a query parameter rather than a path resource, you scope access at the operation level: import only the endpoints you want the agent to call, such as /Urls/data for extraction or /Urls/browser-screenshot for screenshots, and leave out ones like /Urls/social-media or /Urls/browser-data if the agent should not run them. Any operation you do not allow is simply unavailable to the agent, and your stored HTTP Basic credentials are injected only for the calls you permit.
Know of an official OpenAPI document? Contribute it →
For Agents
Extract structured data, screenshots, social profiles, and tabular content from any URL via 8 basic-auth endpoints.
Use for: Extract structured data from a website by URL, Generate a screenshot of a webpage for a link preview, Find all social-media accounts mentioned on a website, Retrieve tabular data from an HTML page
Not supported: Does not handle bulk crawling of entire domains, JavaScript form submission, or login-gated content - use for single-URL data extraction and screenshots only.
Jentic publishes the only available OpenAPI specification for link.fish API, keeping it validated and agent-ready. The link.fish API extracts structured data from arbitrary websites by URL - including the page's main content, social-media accounts, geo-coordinates, and tabular data. Eight endpoints cover full-page extraction, browser-rendered extraction, screenshot generation, and lookup helpers for mobile apps, JSON/XML structures, and tabular content. Authentication uses HTTP Basic with a username and password issued by link.fish, and the API is served only over HTTPS.