API Documentation

Extract structured data from any website using our powerful and simple API. Support for products, articles, jobs, and more.

Quick Start

1

Get your API key

Sign up and generate an API key from your dashboard

2

Make your first request

Send a POST request to /api/extract with your target URL

3

Get structured data

Receive clean, structured JSON data ready to use in your application

Supported Extraction Types

Product

Extract data from a single product page

type: "product"

Product List

Extract products from a listing page

type: "productList"

Article

Extract data from an article or blog post

type: "article"

Article List

Extract articles from a listing page

type: "articleList"

Job Posting

Extract data from a job posting

type: "jobPosting"

Job List

Extract jobs from a listing page

type: "jobPostingNavigation"

SERP

Extract Google search results

type: "serp"

Authentication

All API requests require authentication using your API key. Pass it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Alternative: You can also pass the API key as a query parameter ?apiKey=YOUR_API_KEY

Main Endpoint

POST/api/extract

Extract structured data from any website

Request Body Parameters

urlrequiredstring

The URL of the page to extract data from

typerequiredstring

The type of data to extract:

product | productList | productNavigation | article | articleList | articleNavigation | forumThread | jobPosting | jobPostingNavigation | pageContent | serp
sourceoptional | string

Extraction method (default: browserHtml):

  • httpResponseBody - Fast & cheap, works for most sites
  • browserHtmlOnly - Better for JavaScript-heavy sites
  • browserHtml - Best quality with visual features
countryoptional | string

2-letter ISO country code for geolocation (e.g., FR, US, GB, DE)

Response Format

{
  "success": true,
  "data": {
    // Extracted data structure depends on the type
    // See examples below for each type
  },
  "metadata": {
    "extractionType": "product",
    "source": "browserHtml",
    "country": "FR",
    "processingTime": 2341,
    "creditsUsed": 2,
    "creditsRemaining": 98
  }
}

Code Examples

curl -X POST "https://fetchify.app/api/extract" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/123",
    "type": "product",
    "source": "browserHtml"
  }'

Credit Costs

Credits are automatically deducted based on the extraction type and method:

Extraction TypehttpResponseBodybrowserHtmlOnlybrowserHtml
product, article, jobPosting1 credit2 credits3 credits
productList, articleList2 credits3 credits5 credits
serp (non-AI)1 credit1 credit2 credits

Try It Out

Error Codes

401Unauthorized

Invalid or missing API key

402Payment Required

Insufficient credits

429Too Many Requests

Rate limit exceeded (max 60 requests per minute)

500Internal Server Error

Extraction failed or unexpected error occurred