REST API Reference

Base URL

Authentication

Pass your API key in the Authorization header on every request:

Authorization: Bearer sk-your-api-key-here
Content-Type: application/json

Examples

curl -X POST https://subscraper.dev/api/v1/search \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"query": "best mechanical keyboard", "sort": "top", "limit": 5}'

const response = await fetch('https://subscraper.dev/api/v1/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk-your-api-key-here',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    query: 'best mechanical keyboard',
    sort: 'top',
    limit: 5,
  }),
});

const data = await response.json();
console.log(data.results);

import requests

response = requests.post(
    'https://subscraper.dev/api/v1/search',
    headers={
        'Authorization': 'Bearer sk-your-api-key-here',
        'Content-Type': 'application/json',
    },
    json={
        'query': 'best mechanical keyboard',
        'sort': 'top',
        'limit': 5,
    }
)

data = response.json()
print(data['results'])

All Endpoints

All endpoints accept POST · Auth via Bearer token · Response is always JSON

Error Codes