Documentation

The Python-first web runtime for agents. Search, extract, crawl, and interact with any website.

Quick Start

1. Install the SDK

pip install flypython

2. Set your API key

export FLYPYTHON_API_KEY=fp_xxxxxxxx

3. Extract data in one line

import flypython

result = flypython.extract(
    url="https://example.com",
    schema={"title": "string", "price": "number"}
)
print(result.data)

API Reference

POST/v1/extract

Extract

Instantly extract a single URL and return structured data.

curl -X POST https://api.flypython.com/v1/extract \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": "json"}'
POST/v1/search

Search

Search the web and return LLM-ready results with markdown summaries.

curl -X POST https://api.flypython.com/v1/search \
  -H "Content-Type: application/json" \
  -d '{"query": "best LLM agents 2025", "limit": 5}'
POST/v1/crawl

Crawl

Bulk-extract multiple pages from a site with a single request.

curl -X POST https://api.flypython.com/v1/crawl \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "max_pages": 10}'
POST/v1/tasks

Monitor

Create a scheduled monitoring task with change detection and webhooks.

curl -X POST https://api.flypython.com/v1/tasks \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Price Monitor", "target_url": "...", "schedule_cron": "0 */6 * * *"}'

Output Formats

JSON

Structured key-value data. Default for /extract and /crawl.

Markdown

LLM-ready text. Clean, semantic, perfect for RAG pipelines.

HTML

Raw page HTML. Useful when you need the full markup.

Authentication

All API requests require an API Key passed in the Authorization header:

Authorization: Bearer fp_your_api_key_here

Get your API key from the Settings page after signing in.

SDKs

🐍

Python SDK

pip install flypython

Full async & sync support, type hints, automatic retries, and streaming for large crawls.