# Pullwire

> Live web data for AI agents and apps: one API key, one credit balance, many data tools. Send a tool its input as JSON over a REST API and get clean JSON (or CSV) back. AI agents can also call every tool over MCP. You pay credits only for the results you receive.

- API base URL: https://pullwire.dev/api/v1
- Authentication: send your API key in the `x-api-key` header or as `Authorization: Bearer <key>`. Keys start with `af_live_`.
- Start a run: `POST /api/v1/tools/{toolId}/runs` with the tool input as the JSON body. Sync by default (25 s), `?async=1` for a background run (50 s).
- Results: `GET /api/v1/runs/{id}/results?format=json|csv|xlsx`. Balance: `GET /api/v1/me`.
- Pricing: each tool costs a fixed number of credits per result (listed below). New accounts get 2,000 free credits.
- MCP server: https://pullwire.dev/api/mcp (Streamable HTTP). One MCP tool per data tool below, with the same API key and the same credits as the REST API. Send the key in the `x-api-key` header or as `Authorization: Bearer <key>`. Listing the tools needs no key. Setup for Claude Code, Cursor and Claude Desktop: [MCP docs](https://pullwire.dev/docs/mcp).

## Docs

- [Introduction](https://pullwire.dev/docs): What Pullwire is, how it works, and where to start.
- [Quickstart](https://pullwire.dev/docs/quickstart): Create an account, get an API key and make your first call.
- [MCP: Claude, ChatGPT and Cursor](https://pullwire.dev/docs/mcp): Connect Pullwire to Claude, ChatGPT, Cursor, Claude Code and n8n. One server, every tool.
- [TypeScript and Python SDKs](https://pullwire.dev/docs/sdks): Typed clients generated from the OpenAPI document: run a tool, wait for a run, fetch results.
- [n8n](https://pullwire.dev/docs/n8n): Call any tool from the built-in HTTP Request node and split the results into items.
- [Make](https://pullwire.dev/docs/make): Call any tool from the HTTP “Make a request” module and iterate over the results.
- [Zapier](https://pullwire.dev/docs/zapier): Call any tool with Webhooks by Zapier (Custom Request) and use the results in later steps.
- [Authentication](https://pullwire.dev/docs/authentication): Send your API key in the x-api-key header or as a Bearer token. Keys, storage and rate limits.
- [Runs](https://pullwire.dev/docs/runs): Start a run, wait for it or let it run in the background, and fetch the results as JSON or CSV.
- [Datasets](https://pullwire.dev/docs/datasets): Large runs are saved as CSV, Excel and JSON files for 30 days. List them and get private download links.
- [Credits](https://pullwire.dev/docs/credits): One balance for every tool. How credits are reserved before a run, charged per result and released afterwards.
- [Errors](https://pullwire.dev/docs/errors): Every error has the same JSON shape, an HTTP status and a stable code.
- [Tool reference](https://pullwire.dev/docs/tools): Every tool with its ID, price per result and input fields. Generated from the live tool catalog.

## Tools

- [Web Scraper](https://pullwire.dev/docs/tools#scrape): Turn any public web page into clean, LLM-ready Markdown, raw HTML or JSON fields picked with CSS selectors. Optional JavaScript rendering, screenshots and an automatic residential-proxy fallback when a site blocks. 1 credit per result. POST /api/v1/tools/scrape/runs
- [YouTube Transcripts](https://pullwire.dev/docs/tools#youtube-transcripts): Transcripts of YouTube videos with timestamps, chapters, language choice and video metadata. 1 credit per result. POST /api/v1/tools/youtube-transcripts/runs
- [Facebook Ads Library Scraper](https://pullwire.dev/docs/tools#facebook-ads-library): Search the Facebook Ad Library by keyword or advertiser Page ID: ad text, images, videos, CTA, run dates and platforms. No login, no browser. 1 credit per result. POST /api/v1/tools/facebook-ads-library/runs
- [LinkedIn Jobs Scraper](https://pullwire.dev/docs/tools#linkedin-jobs): Search LinkedIn job postings by keyword, location, date posted, work type, experience level and job type: title, company, location, full description, seniority, employment type and applicant count. No login, no browser. 1 credit per result. POST /api/v1/tools/linkedin-jobs/runs
- [Indeed Jobs Scraper](https://pullwire.dev/docs/tools#indeed-jobs): Search Indeed job postings by keyword, job title, company, location and posted date: title, company, rating, salary, job type, benefits, the full description and the employer’s website and size. No login, no browser. Coming soon: the source site blocks requests from our servers, so runs are not reliable until proxy access is switched on. 1 credit per result. POST /api/v1/tools/indeed-jobs/runs
- [Amazon Product Search](https://pullwire.dev/docs/tools#amazon-products): Search amazon.com by keyword and get product listings: title, price, list price, rating, review count, image, badges (Amazon’s Choice / Best Seller) and URL. No login, no browser. Runs through residential network access and is switched on only while our automatic checks pass. Live state: /status. A paused tool answers 503 TOOL_UNAVAILABLE and charges nothing. 1 credit per result. POST /api/v1/tools/amazon-products/runs
- [Amazon Product Reviews](https://pullwire.dev/docs/tools#amazon-reviews): Get the reviews embedded on an amazon.com product page by ASIN or URL: rating, title, date, verified purchase, helpful votes and full text. No login, no browser. Runs through residential network access and is switched on only while our automatic checks pass. Live state: /status. A paused tool answers 503 TOOL_UNAVAILABLE and charges nothing. 1 credit per result. POST /api/v1/tools/amazon-reviews/runs
- [Reddit Posts, Comments & Search](https://pullwire.dev/docs/tools#reddit): Read subreddit listings, run searches or fetch one post with its comments: title, author, text/body, link, created date and permalink. No login, no browser. Runs through residential network access and is switched on only while our automatic checks pass. Live state: /status. A paused tool answers 503 TOOL_UNAVAILABLE and charges nothing. 1 credit per result. POST /api/v1/tools/reddit/runs
- [Zillow Listings Scraper](https://pullwire.dev/docs/tools#zillow): Search Zillow for-sale listings by city/location: price, beds, baths, square footage, Zestimate, home type and status. No login, no browser. Runs through residential network access and is switched on only while our automatic checks pass. Live state: /status. A paused tool answers 503 TOOL_UNAVAILABLE and charges nothing. 1 credit per result. POST /api/v1/tools/zillow/runs
- [Google Maps Leads Scraper](https://pullwire.dev/docs/tools#maps-leads): Find businesses on Google Maps by type and location (optionally within a radius): name, address, phone, website, rating, reviews, categories and opening hours, plus emails (with the page they were found on), phone numbers and social profiles from each business website. One row per company. No login, no browser. 1 credit per result. POST /api/v1/tools/maps-leads/runs
- [Bing & DuckDuckGo SERP API](https://pullwire.dev/docs/tools#serp): Search results from Bing and DuckDuckGo as structured JSON: organic results with position, title, URL and snippet, Bing ads and related searches, result count, pagination, country and language. No browser, no Google. 1 credit per result. POST /api/v1/tools/serp/runs
- [Glassdoor Jobs Scraper](https://pullwire.dev/docs/tools#glassdoor-jobs): Search Glassdoor job listings by keyword and location: title, company, company rating, location, salary range, posted age, Easy Apply flag, description snippet and skills. No login, no browser. Coming soon: the source site blocks requests from our servers, so runs are not reliable until proxy access is switched on. 1 credit per result. POST /api/v1/tools/glassdoor-jobs/runs
- [Yelp Business & Reviews Scraper](https://pullwire.dev/docs/tools#yelp): Search Yelp businesses by keyword and location or scrape business URLs: name, rating, review count, categories, price, phone, website, address, coordinates, opening hours and optional full review texts. No login, no browser. Coming soon: the source site blocks requests from our servers, so runs are not reliable until proxy access is switched on. 1 credit per result. POST /api/v1/tools/yelp/runs
- [Idealista Scraper](https://pullwire.dev/docs/tools#idealista): Scrape idealista.com property listings for any Spanish city, district or search URL: price, price drops, rooms, size, floor, lift, parking, agency, coordinates, photos. Homes, offices, premises, garages, land and rooms, for sale or rent. Coming soon: the source site blocks requests from our servers, so runs are not reliable until proxy access is switched on. 1 credit per result. POST /api/v1/tools/idealista/runs
- [Threads Scraper](https://pullwire.dev/docs/tools#threads): Scrape public Threads posts by keyword search, profile or post URL: text, author, likes, replies, reposts, images, videos, links, mentions, profile details and the first page of replies. No login, no browser. 1 credit per result. POST /api/v1/tools/threads/runs
- [Website Contact Scraper](https://pullwire.dev/docs/tools#website-contacts): Get email addresses, phone numbers and Facebook, Instagram, LinkedIn, X, YouTube, TikTok and Pinterest profiles from a list of company websites: homepage plus contact and imprint pages. No login, no browser. 1 credit per result. POST /api/v1/tools/website-contacts/runs
- [LinkedIn Company Scraper](https://pullwire.dev/docs/tools#linkedin-company): Get public LinkedIn company data from a company URL or website domain: industry, size, employees on LinkedIn, headquarters and address, all locations, website, type, founding year, specialties, followers, similar companies and recent posts. No login. Runs through residential network access and is switched on only while our automatic checks pass. Live state: /status. A paused tool answers 503 TOOL_UNAVAILABLE and charges nothing. 1 credit per result. POST /api/v1/tools/linkedin-company/runs

## API reference

- [OpenAPI 3 spec](https://pullwire.dev/api/v1/openapi.json): Machine-readable description of every endpoint.
- [Tool catalog (JSON)](https://pullwire.dev/api/v1/tools): Live list of all tools with price and JSON Schema of the input.

## Optional

- [Full docs in one file](https://pullwire.dev/llms-full.txt): Every docs page and the full tool reference.