API Authentication

Getting Your API Key

1. 1

   Sign In

   Log in to your Audioscrape account at audioscrape.com

2. 2

   Go to API Keys

   Navigate to Profile → API Keys

3. 3

   Create a Key

   Click "Create New Key" and give it a descriptive name

4. 4

   Copy Your Key

   Copy the key immediately - it will only be shown once

Using Your API Key

Include your API key in the Authorization header as a Bearer token:

curl -X POST "https://www.audioscrape.com/api/v1/search" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "artificial intelligence"}'

Example: JavaScript/Node.js

const response = await fetch('https://www.audioscrape.com/api/v1/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'artificial intelligence'
  })
});

const data = await response.json();

Example: Python

import requests

response = requests.post(
    'https://www.audioscrape.com/api/v1/search',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'query': 'artificial intelligence'
    }
)

data = response.json()

Error Responses

{"error": "Unauthorized", "message": "Invalid or missing API key"}

{"error": "Forbidden", "message": "Insufficient permissions"}

{"error": "Rate Limited", "message": "Too many requests", "retry_after": 60}

Rate Limits

API rate limits vary by subscription plan:

See pricing for full details on each plan.

Need Help?

Having trouble with authentication? Contact us at [email protected].