v50

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-112650216.3 KB
Scrapers

Read pricing

Returns paid scraper plans, per-result scraper prices, top-up balance rules, and next actions.

get/v1/pricing

Response

Pricing loaded.

nextActionsstring[] required

Example response

{
  "plans": [
    {
      "plan": "plus",
      "monthlyPriceUsdCents": 2000,
      "planBalanceUsdCents": 2000,
      "includedBalanceUsdCents": 2000,
      "bonusBalanceUsdCents": 0,
      "paidOveragesEnabled": false
    },
    {
      "plan": "pro",
      "monthlyPriceUsdCents": 10000,
      "planBalanceUsdCents": 10000,
      "includedBalanceUsdCents": 12000,
      "bonusBalanceUsdCents": 2000,
      "paidOveragesEnabled": false
    },
    {
      "plan": "max",
      "monthlyPriceUsdCents": 20000,
      "planBalanceUsdCents": 20000,
      "includedBalanceUsdCents": 30000,
      "bonusBalanceUsdCents": 10000,
      "paidOveragesEnabled": false
    }
  ],
  "scraperPrices": [
    {
      "scraper": "reddit",
      "priceEvent": "reddit_record",
      "unit": "record",
      "usdMicrosPerResult": 700
    },
    {
      "scraper": "github",
      "priceEvent": "github_record",
      "unit": "record",
      "usdMicrosPerResult": 600
    },
    {
      "scraper": "google-maps",
      "priceEvent": "google_maps_place",
      "unit": "place",
      "usdMicrosPerResult": 1200
    },
    {
      "scraper": "amazon",
      "priceEvent": "amazon_record",
      "unit": "record",
      "usdMicrosPerResult": 1400
    },
    {
      "scraper": "alibaba",
      "priceEvent": "alibaba_record",
      "unit": "record",
      "usdMicrosPerResult": 1500
    },
    {
      "scraper": "temu",
      "priceEvent": "temu_record",
      "unit": "record",
      "usdMicrosPerResult": 1600
    },
    {
      "scraper": "etsy",
      "priceEvent": "etsy_record",
      "unit": "record",
      "usdMicrosPerResult": 1200
    },
    {
      "scraper": "apple-app-store",
      "priceEvent": "apple_app_store_record",
      "unit": "record",
      "usdMicrosPerResult": 1400
    },
    {
      "scraper": "google-play-store",
      "priceEvent": "google_play_store_record",
      "unit": "record",
      "usdMicrosPerResult": 1400
    },
    {
      "scraper": "trendyol",
      "priceEvent": "trendyol_record",
      "unit": "record",
      "usdMicrosPerResult": 1400
    },
    {
      "scraper": "hepsiburada",
      "priceEvent": "hepsiburada_record",
      "unit": "record",
      "usdMicrosPerResult": 1400
    },
    {
      "scraper": "youtube",
      "priceEvent": "youtube_record",
      "unit": "record",
      "usdMicrosPerResult": 1400
    },
    {
      "scraper": "zillow",
      "priceEvent": "zillow_record",
      "unit": "record",
      "usdMicrosPerResult": 1500
    },
    {
      "scraper": "indeed",
      "priceEvent": "indeed_record",
      "unit": "record",
      "usdMicrosPerResult": 1200
    },
    {
      "scraper": "trustpilot",
      "priceEvent": "trustpilot_record",
      "unit": "record",
      "usdMicrosPerResult": 1000
    },
    {
      "scraper": "tiktok",
      "priceEvent": "tiktok_record",
      "unit": "record",
      "usdMicrosPerResult": 1700
    },
    {
      "scraper": "instagram",
      "priceEvent": "instagram_record",
      "unit": "record",
      "usdMicrosPerResult": 800
    },
    {
      "scraper": "x",
      "priceEvent": "x_post",
      "unit": "post",
      "usdMicrosPerResult": 300
    }
  ],
  "topUp": {
    "minimumUsdCents": 2000,
    "maximumUsdCents": 100000,
    "expiresAfterInactiveDays": 365
  },
  "nextActions": [
    "Use `tovuk scraper list --json` and `tovuk scraper show <scraper> --json` to choose a public-data scraper.",
    "Use `scraperPrices[].usdMicrosPerResult`, request limits, and `tovuk usage --json` to estimate balance impact before high-count requests."
  ]
}