Authentication

Overview

Scrape Loop API uses API keys for authentication. You can provide your API key in one of two ways:

1. As a header (recommended)
2. As a query parameter

API Key Methods

Header Method

curl -X GET "https://api.scrapeloop.com/v1/recipes" \
  -H "x-api-key: YOUR_API_KEY"

Header Details

Name	Value
Header Name	x-api-key
Value	Your API key

Query Parameter

curl -X GET "https://api.scrapeloop.com/v1/recipes?apiKey=YOUR_API_KEY"

Query Parameter Details

Name	Value
Parameter Name	apiKey
Value	Your API key

Implementation Examples

Node.js

const apiKey = process.env.SCRAPE_LOOP_API_KEY;

// Using header authentication
async function fetchRecipes() {
  const response = await fetch('https://api.scrapeloop.com/v1/recipes', {
    headers: {
      'x-api-key': apiKey
    }
  });
  return await response.json();
}

Python

import os
import requests

api_key = os.environ.get('SCRAPE_LOOP_API_KEY')

# Using header authentication
def fetch_recipes():
    headers = {'x-api-key': api_key}
    response = requests.get(
        'https://api.scrapeloop.com/v1/recipes',
        headers=headers
    )
    return response.json()

Error Handling

Common Authentication Errors

Error Code	Description	Solution
401	Missing API key	Include API key in header or query parameter
401	Invalid API key	Check if the API key is correct and active
403	Insufficient permissions	Verify API key has required permissions

Error Response Example

{
  "success": false,
  "message": "Invalid API key provided",
  "statusCode": 401
}