# Introduction

> What Pullwire is, how it works, and where to start.

Pullwire gives your AI agent or app live data from the web. You get **one API key** and **one credit balance**, and every data tool works the same way: send an input, get clean JSON back, pay only for the results you receive.

## How it works [#how-it-works]

1. **Pick a tool.** Each tool reads one kind of public web data, for example YouTube transcripts, job listings or ads from the Facebook Ad Library. The full list is in the [tool reference](/docs/tools).
2. **Start a run.** Send the tool's input as JSON to `POST /api/v1/tools/{toolId}/runs` with your API key.
3. **Get results.** Short runs answer right away with the results. Longer runs can run in the background; you fetch the results when they are done, as JSON or CSV.
4. **Pay per result.** Each result costs the credits listed for its tool. Before a run starts, credits are set aside for the most results it can return; afterwards you are charged only for the results you actually got and the rest goes back to your balance.

## Where to go next [#where-to-go-next]

<Cards>
  <Card title="Quickstart" href="/docs/quickstart" description="Your first API call in a few minutes." />
  <Card title="Runs" href="/docs/runs" description="Sync and async runs, statuses, results as JSON or CSV." />
  <Card title="Credits" href="/docs/credits" description="How credits are reserved, charged and released." />
  <Card title="Tool reference" href="/docs/tools" description="Every tool with its input fields and price." />
</Cards>

## Connect [#connect]

<Cards>
  <Card title="MCP: Claude and Cursor" href="/docs/mcp" description="Your agent finds and uses every tool by itself." />
  <Card title="TypeScript and Python" href="/docs/sdks" description="Typed SDKs generated from the OpenAPI document." />
  <Card title="n8n" href="/docs/n8n" description="One HTTP Request node, imported from cURL." />
  <Card title="Make" href="/docs/make" description="The HTTP module plus an Iterator." />
  <Card title="Zapier" href="/docs/zapier" description="Webhooks by Zapier, Custom Request." />
</Cards>

## For AI agents [#for-ai-agents]

These docs are also available as plain text, so an agent can read them without rendering HTML:

- [`/llms.txt`](/llms.txt): a short index of the docs and all tools.
- [`/llms-full.txt`](/llms-full.txt): every docs page and the full tool reference in one file.
- [`/api/v1/openapi.json`](/api/v1/openapi.json): the OpenAPI 3 description of the API.
- [`/api/v1/tools`](/api/v1/tools): the live tool catalog as JSON, including each tool's input schema.