{
  "username": "natgeo",
  "include_recent_posts": false  // optional
}

{
  "username": "natgeo",
  "full_name": "National Geographic",
  "biography": "...",
  "followers": 283000000,
  "following": 156,
  "posts_count": 28500,
  "profile_pic_url": "https://...",
  "is_verified": true,
  "external_url": "https://natgeo.com"
}

{
  "username": "natgeo"
}

{
  "username": "natgeo"
}

{
  "hashtag": "travel"
}

{
  "shortcode": "CxYzAbC1234"
}

{
  "slug": "Agent-Name"  // from zillow.com/profile/Agent-Name
}

{
  "location": "San Francisco, CA",  // required
  "price_min": 200000,              // optional
  "price_max": 800000,              // optional
  "beds_min": 2,                    // optional (0-10)
  "baths_min": 1,                   // optional (0-10)
  "sqft_min": 1000,                 // optional
  "sqft_max": 5000,                 // optional
  "property_type": "house",         // optional: house|condo|townhouse|multi_family|land
  "status": "for_sale"              // optional: for_sale|sold|pending
}

{
  "location": "San Francisco, CA",
  "total_count": 1250,
  "properties": [
    {
      "address": "123 Market St, San Francisco, CA 94105",
      "price": 950000,
      "beds": 2,
      "baths": 2,
      "sqft": 1200,
      "property_type": "condo",
      "listing_url": "https://zillow.com/...",
      "thumbnail_url": "https://...",
      "latitude": 37.7749,
      "longitude": -122.4194
    }
  ],
  "metadata": {
    "pages_scraped": 8,
    "duration_seconds": 45,
    "price_buckets_used": false
  }
}

{
  "location": "Denver, CO"  // city, zip, or address
}

{
  "location": "Denver, CO",
  "total_count": 350,
  "properties": [
    {
      "address": "2490 S Garfield St, Denver, CO 80210",
      "street": "2490 S Garfield St",
      "city": "Denver",
      "state": "CO",
      "zip": "80210",
      "price": 1950000,
      "beds": 5,
      "baths": 5,
      "sqft": 3607,
      "listing_url": "https://www.redfin.com/CO/Denver/...",
      "thumbnail_url": "https://ssl.cdn-redfin.com/...",
      "mls_id": "7892039",
      "latitude": 39.6712,
      "longitude": -104.9440,
      "source": "redfin"
    }
  ]
}

{
  "location": "Austin, TX"  // city/state or zip code
}

{
  "location": "Austin, TX",
  "total_count": 2000,
  "properties": [
    {
      "address": "315 Leaning Rock Rdg, Austin, TX 78737",
      "city": "Austin",
      "state": "TX",
      "zip": "78737",
      "price": 936460,
      "beds": 4,
      "baths": 3,
      "sqft": 2850,
      "property_type": "single_family",
      "status": "for_sale",
      "listing_url": "https://www.realtor.com/...",
      "thumbnail_url": "https://...",
      "latitude": 30.2672,
      "longitude": -97.7431,
      "source": "realtor"
    }
  ]
}

{
  "channel": "@MrBeast"  // handle, channel ID, or full URL
}

{
  "video_url": "https://youtube.com/watch?v=dQw4w9WgXcQ"
}

{
  "advertiser": "Nike"  // advertiser name, ad ID, or ad library URL
}

{
  "username": "@charlidamelio"  // @handle, username, or full URL
}

{
  "profile": {
    "username": "charlidamelio",
    "display_name": "Charli D'Amelio",
    "follower_count": 155000000,
    "following_count": 1200,
    "bio": "...",
    "profile_pic_url": "https://...",
    "video_count": 30,
    "total_views": 450000000,
    "avg_views": 15000000
  },
  "videos": [
    {
      "video_id": "7341...",
      "title": "Video title...",
      "view_count": 25000000,
      "like_count": 1200000,
      "comment_count": 8500,
      "share_count": 45000,
      "thumbnail_url": "https://...",
      "video_url": "https://...",
      "outlier_score": 1.67
    }
  ]
}

{
  "video_url": "https://www.tiktok.com/@user/video/7341..."
}

{
  "profile_url": "https://linkedin.com/in/satyanadella"
  // or just: "satyanadella"
}

{
  "name": "Satya Nadella",
  "headline": "Chairman and CEO at Microsoft",
  "location": "Greater Seattle Area",
  "profile_url": "https://linkedin.com/in/satyanadella",
  "profile_pic_url": "https://...",
  "summary": "...",
  "experience": [
    {
      "title": "Chairman and CEO",
      "company": "Microsoft",
      "duration": "2014 - Present"
    }
  ],
  "education": [...],
  "skills": [...]
}

{
  "query": "software engineer san francisco"
}

{
  "query": "product manager",
  "location": "New York"  // optional
}

{
  "username": "elonmusk"
}

{
  "username": "elonmusk",
  "name": "Elon Musk",
  "bio": "...",
  "followers_count": 195000000,
  "following_count": 836,
  "tweet_count": 48291,
  "verified": true,
  "profile_image_url": "https://...",
  "banner_url": "https://...",
  "location": "Mars & Earth",
  "website": "https://..."
}

{
  "query": "AI startups funding"
}

{
  "query": "hiring react developer",
  "location": "remote"  // optional
}

{
  "usernames": ["natgeo", "nasa", "spacex"],
  "type": "profile"  // profile | posts | reels
}

{
  "jobs": [
    { "job_id": "abc1", "target": "natgeo", "status": "queued" },
    { "job_id": "abc2", "target": "nasa", "status": "queued" },
    { "job_id": "abc3", "target": "spacex", "status": "queued" }
  ],
  "total_credits_used": 3
}

{
  "jobs": [
    {
      "job_id": "abc123",
      "type": "profile",
      "target": "natgeo",
      "status": "completed",
      "created_at": "2026-03-05T10:00:00Z",
      "completed_at": "2026-03-05T10:00:15Z"
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

{
  "job_id": "abc123",
  "type": "profile",
  "target": "natgeo",
  "status": "completed",
  "data": { ... },
  "error": null,
  "created_at": "2026-03-05T10:00:00Z",
  "completed_at": "2026-03-05T10:00:15Z"
}

{
  "url": "https://your-app.com/webhooks/scrapeapi",
  "events": ["job.completed", "job.failed"]  // optional, defaults to both
}

{
  "id": "wh_abc123",
  "url": "https://your-app.com/webhooks/scrapeapi",
  "secret": "whsec_abc123...",
  "events": ["job.completed", "job.failed"],
  "active": true,
  "created_at": "2026-03-05T10:00:00Z"
}

{
  "url": "https://new-url.com/hook",
  "events": ["job.completed"],
  "active": false
}

{
  "type": "profile",           // profile | posts | reels | hashtags
  "target": "natgeo",          // username or hashtag
  "interval": "daily"          // daily | weekly | monthly
}

{
  "id": "sch_abc123",
  "type": "profile",
  "target": "natgeo",
  "interval": "daily",
  "active": true,
  "next_run_at": "2026-03-06T00:00:00Z",
  "created_at": "2026-03-05T10:00:00Z"
}

{
  "interval": "weekly",
  "active": false
}

{
  "tier": "pro"  // pro | business | enterprise
}

{
  "url": "https://checkout.stripe.com/c/pay/..."
}

{
  "url": "https://billing.stripe.com/p/session/..."
}