Skip to main content
Use ParseHub through Corsair: one client, typed API calls, local DB sync. Things to know before you call:
  • Projects are built in the ParseHub desktop app. The API lists, runs and reads projects; it cannot create or edit them.
  • A run is asynchronous. projects.run returns the new run straight away. Poll runs.get until data_ready is true or status is cancelled or error (ParseHub allows 25 polls in a run’s first 5 minutes, then one every 3 minutes). A cancelled or failed run may have no data; when data_ready is true, call runs.getData. projects.getLastReadyData skips the polling and returns the newest finished data.
  • Data comes as JSON or CSV. format: 'csv' returns the CSV as a string.
  • The key is the api_key parameter. The client sends it in the query string on every call, where Corsair redacts it from errors. With no key stored, Corsair raises AuthMissingError before any request; a key ParseHub rejects comes back as HTTP 401.
  • Limits. 5 requests a second (up to 25 queued); projects.list returns at most 20 projects per page.
What you get:
  • 8 typed API operations
  • 1 synced entity (projects) for fast .search() / .list()

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Get the latest scraped data of a project
Run a project with a search value
See the full list on the API page.

Query synced data

Synced entities support tenant.parsehub.db.<entity>.search() and .list(): projects. See Database for filters and operators.

What’s next

API reference

Every parsehub.api.* operation with input and output types.

Database

Synced entities, search filters, and operators.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.