Introduction

datacaiman — web scraping APIs for search engines, social media, real estate, and more

What is datacaiman?

datacaiman is a credit-based API platform that gives you access to web scraping APIs for search engines, social media, real estate, classifieds, and travel — all through simple REST endpoints.

How it works

  1. Sign up and get 10 free credits.
  2. Create an API key from the API Keys page.
  3. Call any endpoint with your key in the X-API-Key header.
  4. Each call costs 1 credit (some endpoints may cost more — check the individual API pages).

Credits reset at the start of each billing period.

Base URL

All API endpoints are served from:

https://api.datacaiman.com/v1

Authentication

Include your API key in every request using one of these two methods:

X-API-Key: dc_your_key_here

or

Authorization: Bearer dc_your_key_here

Response format

All endpoints return JSON. Errors always include an error field:

{ "error": "human readable message" }

Common error status codes:

Code Meaning
400 Invalid or missing request parameters
401 Missing or invalid API key
402 Insufficient credits
500 Upstream scraping error (not charged)

Available APIs

API Base path Description
Google Search /v1/google Google organic search results
Twitter/X /v1/twitter Tweet search and user timelines
Idealista /v1/idealista Real estate listings (ES, PT, IT)
Flight Award /v1/flightaward Airline award availability
OfferUp /v1/offerup US marketplace classifieds