https://app.scrapely.co/api/v1

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/accounts

# Generate TypeScript client
npx openapi-typescript-codegen --input https://app.scrapely.co/openapi.yaml --output ./api

# Generate Python client
pip install openapi-python-client
openapi-python-client generate --url https://app.scrapely.co/openapi.yaml

# Import into Postman
# File -> Import -> Link -> https://app.scrapely.co/openapi.yaml

curl -H "X-API-Key: sk_live_your_api_key" \
  https://app.scrapely.co/api/v1/accounts

curl -H "Authorization: Bearer sk_live_your_api_key" \
  https://app.scrapely.co/api/v1/accounts

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/accounts

{
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "handle": "yourhandle",
      "name": "Your Name",
      "profile_image_url": "https://pbs.twimg.com/...",
      "is_active": true,
      "is_verified": true,
      "dms_sent": 1250,
      "pending_count": 340,
      "created_at": "2024-01-15T10:30:00Z",
      "cookies": [
        { "name": "auth_token", "value": "abc123...", "domain": ".x.com" },
        { "name": "ct0", "value": "xyz789...", "domain": ".x.com" }
      ],
      "proxy": "161.77.187.46:12323",
      "proxy_auth": "username:password",
      "is_paused": false,
      "followups_paused": false,
      "warmup_paused": false,
      "ai_setter_enabled": true
    }
  ]
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "myhandle",
    "cookies": [
      {"name": "ct0", "value": "abc123...", "domain": ".twitter.com"},
      {"name": "auth_token", "value": "xyz789...", "domain": ".twitter.com"}
    ],
    "proxy": "http://proxy.example.com:8080",
    "proxy_auth": "username:password",
    "xchat_pin": "123456"
  }' \
  https://app.scrapely.co/api/v1/accounts

{
  "success": true,
  "message": "Account created successfully",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "handle": "myhandle",
    "is_active": true,
    "created_at": "2024-01-15T10:30:00Z",
    "is_new": true
  }
}

curl -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000"
  }' \
  https://app.scrapely.co/api/v1/accounts

curl -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "myhandle"
  }' \
  https://app.scrapely.co/api/v1/accounts

{
  "success": true,
  "message": "Account removed successfully",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "handle": "myhandle"
  }
}

curl -X PUT \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "cookies": [
      {"name": "ct0", "value": "new_value...", "domain": ".twitter.com"},
      {"name": "auth_token", "value": "new_token...", "domain": ".twitter.com"}
    ]
  }' \
  https://app.scrapely.co/api/v1/accounts/cookies

{
  "success": true,
  "message": "Cookies updated successfully",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "handle": "myhandle",
    "is_active": true
  }
}

curl -X PUT \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "proxy": "161.77.187.46:12323",
    "proxy_auth": "username:password"
  }' \
  https://app.scrapely.co/api/v1/accounts/proxy

{
  "success": true,
  "message": "Proxy updated successfully",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "handle": "myhandle",
    "proxy": "161.77.187.46:12323",
    "proxy_auth": "username:password"
  }
}

curl -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "is_paused": true
  }' \
  https://app.scrapely.co/api/v1/accounts/pause

{
  "success": true,
  "message": "Account paused",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "handle": "myhandle",
    "is_paused": true
  }
}

curl -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "followups_paused": true
  }' \
  https://app.scrapely.co/api/v1/accounts/pause-followups

{
  "success": true,
  "message": "Follow-ups paused",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "handle": "myhandle",
    "followups_paused": true
  }
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_account_ids": ["550e8400-e29b-41d4-a716-446655440000"],
    "to_account_ids": [
      "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
    ],
    "dry_run": true
  }' \
  https://app.scrapely.co/api/v1/accounts/reassign-pending

{
  "success": true,
  "dry_run": true,
  "moved_count": 340,
  "message": "Would move 340 pending DMs (nothing changed)",
  "accounts": [
    { "id": "550e8400-e29b-41d4-a716-446655440000", "handle": "tiredaccount", "change": -340 },
    { "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "handle": "freshaccount1", "change": 170 },
    { "id": "6ba7b811-9dad-11d1-80b4-00c04fd430c8", "handle": "freshaccount2", "change": 170 }
  ]
}

curl -X PATCH \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "warmup_paused": true
  }' \
  https://app.scrapely.co/api/v1/accounts/warmup

{
  "success": true,
  "message": "Warmup paused",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "handle": "myhandle",
    "warmup_paused": true
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/accounts/tags?account_id=550e8400-e29b-41d4-a716-446655440000"

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "handle": "myhandle",
  "tags": ["lead-gen", "warm-account", "high-priority"]
}

{
  "accounts": [
    {
      "account_id": "550e8400-e29b-41d4-a716-446655440000",
      "handle": "myhandle",
      "tags": ["lead-gen", "warm-account"]
    },
    {
      "account_id": "660f9511-f30c-52e5-b827-557766551111",
      "handle": "otherhandle",
      "tags": ["outbound"]
    }
  ]
}

curl -X PUT \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "tags": ["lead-gen", "warm-account", "high-priority"]
  }' \
  https://app.scrapely.co/api/v1/accounts/tags

{
  "success": true,
  "message": "Tags updated",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "handle": "myhandle",
  "tags": ["lead-gen", "warm-account", "high-priority"]
}

curl -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "add": ["vip", "enterprise"],
    "remove": ["warm-account"]
  }' \
  https://app.scrapely.co/api/v1/accounts/tags

{
  "success": true,
  "message": "Tags updated",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "handle": "myhandle",
  "tags": ["lead-gen", "high-priority", "vip", "enterprise"]
}

curl -X PATCH "https://app.scrapely.co/api/v1/accounts/handle" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "550e8400-e29b-41d4-a716-446655440000", "handle": "@new_handle"}'

{
  "success": true,
  "message": "Handle updated successfully",
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "old_handle": "old_handle",
    "new_handle": "new_handle"
  }
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech Founders Q1",
    "sources": [
      {
        "handle": "paulg",
        "followers": true
      },
      {
        "handle": "naval",
        "followers": true,
        "following": true
      }
    ],
    "filters": {
      "includeKeywords": [["founder", "ceo"], ["startup"]],
      "includeBetweenLogic": "OR",
      "includeWithinLogic": "AND",
      "excludeKeywords": [["hiring", "recruiter"]],
      "followers": { "min": 100, "max": 50000 },
      "hasWebsite": true,
      "dmsOpen": true,
      "lastActiveHours": 24
    }
  }' \
  https://app.scrapely.co/api/v1/scraping-sources

{
  "success": true,
  "lead_source_id": "uuid-here",
  "name": "Tech Founders Q1",
  "jobs_created": 3,
  "message": "Scraping all followers/following. Credits deducted as leads are imported.",
  "jobs": [
    {
      "id": "job-uuid-1",
      "type": "followers",
      "handle": "paulg",
      "status": "pending"
    },
    {
      "id": "job-uuid-2",
      "type": "followers",
      "handle": "naval",
      "status": "pending"
    },
    {
      "id": "job-uuid-3",
      "type": "following",
      "handle": "naval",
      "status": "pending"
    }
  ]
}

curl -X POST "https://app.scrapely.co/api/v1/scraping-sources/commenters" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Viral Tweet Commenters",
    "tweets": [
      {
        "url": "https://x.com/elonmusk/status/1234567890",
        "max_leads": 500
      },
      {
        "url": "https://x.com/naval/status/9876543210",
        "max_leads": 300
      }
    ],
    "filters": {
      "includeKeywords": [["founder", "CEO"]],
      "followers": { "min": 1000 }
    }
  }'

{
  "success": true,
  "lead_source_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Viral Tweet Commenters",
  "jobs_created": 2,
  "total_max_leads": 800,
  "jobs": [
    {
      "id": "job-uuid-1",
      "type": "commenters",
      "tweet_url": "https://x.com/elonmusk/status/1234567890",
      "max_leads": 500,
      "status": "pending"
    },
    {
      "id": "job-uuid-2",
      "type": "commenters",
      "tweet_url": "https://x.com/naval/status/9876543210",
      "max_leads": 300,
      "status": "pending"
    }
  ]
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/scraping-sources?id=uuid-here"

{
  "scraping_source": {
    "id": "uuid-here",
    "name": "Tech Founders Q1",
    "status": "processing",
    "leads_imported": 4200,
    "total_leads": 9000,
    "profiles_processed": 8500,
    "progress": 47,
    "filters": {
      "includeKeywords": [["CTO", "VP Engineering", "Head of Eng"]],
      "excludeKeywords": [["recruiter", "hiring", "student"]],
      "includeWithinLogic": "OR",
      "includeBetweenLogic": "AND",
      "excludeWithinLogic": "OR",
      "excludeBetweenLogic": "AND",
      "followers": { "min": "250", "max": "50000" },
      "following": { "min": "", "max": "" },
      "hasWebsite": null,
      "isBlueVerified": true,
      "dmsOpen": true,
      "lastActiveHours": 24,
      "locationExcludeKeywords": "India, Nigeria, ..."
    },
    "handles": [
      {
        "handle": "paulg",
        "followers": {
          "id": 1234,
          "status": "completed",
          "leads_imported": 5000,
          "profiles_processed": 45000,
          "max_leads": 5000
        },
        "following": null
      }
    ],
    "created_at": "2024-01-15T10:30:00Z"
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/scraping-sources/LEAD_SOURCE_ID/leads?limit=100&min_followers=500&bio_contains=founder,ceo"

{
  "leads": [
    {
      "twitter_handle": "janedoe",
      "lead_source_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Jane Doe",
      "bio": "Founder @acme | Building cool stuff",
      "followers_count": 4500,
      "following_count": 320,
      "location": "San Francisco, CA",
      "website": "https://acme.com",
      "is_blue_verified": false
    }
  ],
  "pagination": {
    "next_cursor": "eyJjIjoiMjAyNi0xMC0xMlQxNTowMDowMFoiLCJpIjoiYWJjIn0",
    "has_more": true,
    "count": 100
  }
}

curl -X POST "https://app.scrapely.co/api/v1/import-leads" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Imported Leads",
    "leads": [
      {
        "twitter_handle": "elonmusk",
        "name": "Elon Musk",
        "description": "CEO of Tesla & SpaceX",
        "follower_count": 150000000,
        "website": "https://tesla.com"
      },
      {
        "twitter_handle": "naval",
        "name": "Naval Ravikant",
        "description": "Angel investor",
        "follower_count": 2000000
      }
    ]
  }'

{
  "success": true,
  "lead_source_id": "550e8400-e29b-41d4-a716-446655440000",
  "lead_source_name": "My Imported Leads",
  "imported_count": 2,
  "skipped_count": 0,
  "invalid_count": 0
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Outreach Campaign Q1",
    "message_variants": [
      {
        "message": "Hey {{firstName}}, I saw your work and wanted to connect!",
        "media_url": "https://your-project.supabase.co/storage/v1/object/public/campaign-media/api/123/1760300000000_ab12cd.png",
        "followups": [
          {"wait_time": 3, "wait_unit": "days", "message": "Just bumping this up!"}
        ]
      },
      {
        "message": "Hi {{firstName}}! Quick question about your business..."
      }
    ],
    "lead_source_ids": ["uuid-1", "uuid-2"],
    "enable_follow": true,
    "enable_like": true,
    "enable_comment": true,
    "comment_template": "Great insights on {{topic}}!"
  }' \
  https://app.scrapely.co/api/v1/campaigns

{
  "success": true,
  "campaign_name": "Outreach Campaign Q1",
  "jobs_created": 1500,
  "leads_targeted": 1500,
  "message_variants": 2,
  "accounts_used": 2,
  "distribution": [
    {"account_id": "uuid", "handle": "account1", "jobs": 750},
    {"account_id": "uuid", "handle": "account2", "jobs": 750}
  ]
}

curl -X POST "https://app.scrapely.co/api/v1/campaigns/import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Founders Import",
    "message": "{{Hey|Hi}} {{firstName}}, loved what {{company}} is doing!",
    "leads": [
      { "twitter_handle": "naval", "custom_fields": { "firstName": "Naval", "company": "AngelList" } },
      { "twitter_handle": "https://x.com/paulg", "custom_fields": { "firstName": "Paul", "company": "YC" } }
    ],
    "followups": [
      { "wait_time": 3, "wait_unit": "days", "message": "Any thoughts, {{firstName}}?" }
    ],
    "enable_follow": true,
    "send_window_start": "09:00",
    "send_window_end": "17:00",
    "send_timezone": "America/New_York",
    "send_days": [1, 2, 3, 4, 5]
  }'

{
  "success": true,
  "campaign_name": "Founders Import",
  "jobs_created": 2,
  "skipped_count": 0,
  "invalid_count": 0,
  "message_variants": 1,
  "accounts_used": 2
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/campaigns?limit=10"

{
  "campaigns": [
    {
      "name": "Outreach Campaign Q1",
      "total": 1500,
      "completed": 1200,
      "pending": 250,
      "dms_closed": 40,
      "already_contacted": 10,
      "progress": 80
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "count": 1,
    "total": 5
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/campaigns/analytics

{
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "handle": "myhandle",
      "name": "My Account",
      "profile_image_url": "https://pbs.twimg.com/...",
      "is_paused": false,
      "dms_sent": 1500,
      "dms_sent_24hrs": 45,
      "replies_24hrs": 12,
      "positive_replies_24hrs": 8,
      "responses": 180,
      "response_rate": 12.0,
      "pending_count": 250,
      "sentiment": {
        "positive": 120,
        "negative": 15,
        "neutral": 45
      }
    }
  ],
  "campaigns": [
    {
      "account_id": "550e8400-e29b-41d4-a716-446655440000",
      "account_handle": "myhandle",
      "campaign_name": "Outreach Q1",
      "total": 1500,
      "completed": 1200,
      "pending": 250,
      "remaining": 250,
      "progress": 80,
      "reply_count": 150,
      "response_rate": 12.5
    }
  ],
  "campaignSentimentStats": [
    {
      "campaign_name": "Outreach Q1",
      "account_id": "550e8400-e29b-41d4-a716-446655440000",
      "sentiment": {
        "positive": 100,
        "negative": 12,
        "neutral": 38,
        "total": 150
      },
      "reply_count": 150
    }
  ],
  "campaignVariantStats": [
    {
      "campaign_name": "Outreach Q1",
      "account_id": "550e8400-e29b-41d4-a716-446655440000",
      "variants": [
        {
          "message": "Hey {{firstName}}, loved your recent post...",
          "sent": 600,
          "replied": 90,
          "reply_rate": 15.0
        },
        {
          "message": "Hi {{firstName}}, saw you're building...",
          "sent": 600,
          "replied": 60,
          "reply_rate": 10.0
        }
      ]
    }
  ],
  "totals": {
    "dms_sent": 1500,
    "dms_sent_24hrs": 45,
    "replies_24hrs": 12,
    "positive_replies_24hrs": 8,
    "responses": 180,
    "response_rate": 12.0,
    "positive": 120,
    "negative": 15,
    "neutral": 45
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/campaigns/Outreach%20Q1"

{
  "campaign_name": "Outreach Q1",
  "created_at": "2026-06-01T12:00:00.000Z",
  "totals": {
    "total": 1000,
    "completed": 692,
    "pending": 0,
    "dms_closed": 280,
    "already_contacted": 28,
    "replies": 29,
    "reply_rate": 4.2,
    "positive": 17,
    "negative": 2,
    "neutral": 10
  },
  "accounts": [
    {
      "twitter_account_id": "550e8400-...",
      "handle": "myhandle",
      "profile_image_url": "https://pbs.twimg.com/...",
      "total": 100,
      "completed": 80,
      "pending": 0,
      "replies": 5,
      "reply_rate": 6.3,
      "positive": 3,
      "negative": 1,
      "neutral": 1
    }
  ],
  "replies": [
    {
      "id": "550e8400-...",
      "replier_handle": "prospect_user",
      "replier_name": "Prospect Name",
      "replier_profile_image": "https://pbs.twimg.com/...",
      "reply_message": "Sure, send it over!",
      "reply_sentiment": "positive",
      "replied_at": "2026-06-15T14:30:00.000Z",
      "account_handle": "myhandle"
    }
  ],
  "settings": {
    "message_variants": [
      {
        "message": "Hey {{firstName}}, loved your recent post...",
        "followups": [
          {
            "wait_time": 3,
            "wait_unit": "days",
            "message": "Just following up..."
          }
        ]
      }
    ],
    "followups": [],
    "engagement_actions": {
      "enable_follow": true,
      "enable_like": true,
      "enable_comment": false,
      "comment_template": ""
    }
  },
  "time_series": [
    {
      "period_start": "2026-06-01",
      "period_label": "Jun 1",
      "dms_sent": 45,
      "responses": 3,
      "response_rate": 6.7
    }
  ]
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/campaigns/Founders%20Import/leads?replied=true&limit=100"

{
  "campaign_name": "Founders Import",
  "leads": [
    {
      "job_id": "000e2fb6-4d6c-4449-9605-8bb0b62b198e",
      "twitter_handle": "janedoe",
      "name": "Jane Doe",
      "custom_fields": {
        "first_name": "Jane",
        "company": "Acme",
        "booking_link": "https://cal.com/yourname/intro"
      },
      "status": "completed",
      "account_handle": "your_sender",
      "dm_sent_at": "2026-10-12T15:26:32.000Z",
      "replied": true,
      "reply_sentiment": "positive",
      "followups_sent": 1,
      "created_at": "2026-10-10T09:00:00.000Z"
    }
  ],
  "pagination": { "total": 1, "limit": 100, "offset": 0, "has_more": false }
}

curl -X POST "https://app.scrapely.co/api/v1/campaigns/add-lead-source" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Outreach Campaign Q1",
    "lead_source_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

{
  "success": true,
  "campaign_name": "Outreach Campaign Q1",
  "jobs_created": 450,
  "duplicates_skipped": 50
}

curl -X POST "https://app.scrapely.co/api/v1/campaigns/add-lead" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Outreach Campaign Q1",
    "twitter_handle": "naval"
  }'

curl -X POST "https://app.scrapely.co/api/v1/campaigns/add-lead" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Outreach Campaign Q1",
    "twitter_handles": ["naval", "elonmusk", "paulg"]
  }'

curl -X POST "https://app.scrapely.co/api/v1/campaigns/add-lead" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Founders Import",
    "leads": [
      { "twitter_handle": "janedoe", "custom_fields": { "first_name": "Jane", "company": "Acme" } },
      { "twitter_handle": "johnsmith", "custom_fields": { "first_name": "John", "company": "Globex" } }
    ]
  }'

{
  "success": true,
  "campaign_name": "Outreach Campaign Q1",
  "jobs_created": 3,
  "duplicates_skipped": 0
}

{
  "success": true,
  "campaign_name": "Founders Import",
  "jobs_created": 2,
  "duplicates_skipped": 0,
  "warnings": [
    "2 lead(s) were added to an import campaign without values for {{first_name}}, {{company}}. Their messages can't fill those columns. Pass custom_fields for each lead to fill them."
  ],
  "missing_columns": ["first_name", "company"],
  "leads_missing_columns": 2
}

curl -X POST "https://app.scrapely.co/api/v1/campaigns/pause" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_name": "Summer Outreach", "is_paused": true}'

curl -X POST "https://app.scrapely.co/api/v1/campaigns/rename" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_name": "Summer Outreach", "new_name": "Summer Outreach v2"}'

curl -X POST "https://app.scrapely.co/api/v1/campaigns/settings" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Summer Outreach",
    "send_window_start": "09:00",
    "send_window_end": "17:00",
    "send_timezone": "America/Los_Angeles",
    "send_days": [1, 2, 3, 4, 5],
    "enable_follow": true,
    "enable_like": true
  }'

# From a public link
curl -X POST "https://app.scrapely.co/api/v1/media/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/images/offer.png"}'

# From a local file (base64)
curl -X POST "https://app.scrapely.co/api/v1/media/upload" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"data\": \"$(base64 < offer.png | tr -d '\n')\"}"

{
  "success": true,
  "media_url": "https://your-project.supabase.co/storage/v1/object/public/campaign-media/api/123/1760300000000_ab12cd.png",
  "mime_type": "image/png",
  "size_bytes": 248133
}

curl -X POST "https://app.scrapely.co/api/v1/campaigns/settings" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_name": "Summer Outreach",
    "message_variants": [
      {
        "message": "Hey {{firstName}}, here is the deck I mentioned",
        "media_url": "MEDIA_URL_FROM_UPLOAD",
        "followups": [
          {"wait_time": 3, "wait_unit": "days", "message": "Did you get a chance to look?", "media_url": "MEDIA_URL_FROM_UPLOAD"}
        ]
      }
    ]
  }'

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/conversations?limit=10"

{
  "conversations": [
    {
      "conversation_id": "123456789-987654321",
      "account_handle": "yourhandle",
      "receiver": {
        "screen_name": "prospect",
        "name": "John Doe",
        "bio": "Founder @ Startup",
        "website": "https://example.com",
        "location": "San Francisco",
        "followers_count": 5000
      },
      "origin": {
        "campaign_name": "October launch",
        "variant": "hey John, quick question about Startup...",
        "variant_template": "hey {{firstName}}, quick question about {{company}}...",
        "variant_index": 1
      },
      "last_message": {
        "text": "Thanks for reaching out!",
        "time": 1709234567000,
        "is_sent": false
      },
      "is_unread": true,
      "seen_at": "2026-07-29T08:07:00.000Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "count": 10,
    "has_more": true
  },
  "next_cursor": "eyJ0IjoxNzA5MjM0NTY3MDAwLCJpIjoiYWJjMTIzIn0"
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/conversations?conversation_id=123456789-987654321"

{
  "conversation": {
    "id": "uuid-here",
    "conversation_id": "123456789-987654321",
    "account_handle": "yourhandle",
    "lead": {
      "user_id": "987654321",
      "screen_name": "prospect",
      "name": "John Doe",
      "profile_image_url": "https://pbs.twimg.com/...",
      "profile_banner_url": "https://pbs.twimg.com/...",
      "bio": "Founder @ Startup | Building cool things",
      "location": "San Francisco, CA",
      "website": "https://example.com",
      "followers_count": 5000,
      "following_count": 1200,
      "verified": false
    },
    "crm": {
      "notes": "Interested in enterprise plan",
      "deal_value": 5000.00,
      "deal_currency": "USD"
    },
    "stats": {
      "message_count": 8,
      "is_unread": false,
      "last_message_time": 1709234567000,
      "last_message_text": "Sounds great, let's schedule a call!",
      "last_message_is_sent": false,
      "seen_at": "2026-07-29T08:07:00.000Z"
    },
    "messages": [
      {
        "text": "Hey! Saw your work on...",
        "time": 1709200000000,
        "sender": "123456789",
        "isSent": true
      },
      {
        "text": "Thanks for reaching out!",
        "time": 1709210000000,
        "sender": "987654321",
        "isSent": false
      }
    ],
    "created_at": "2024-02-28T10:00:00.000Z",
    "updated_at": "2024-02-28T12:30:00.000Z"
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/conversations/stats?since=2026-07-01"

{
  "period": {
    "since": "2026-07-01T00:00:00.000Z",
    "until": null
  },
  "dms_sent": 1000,
  "seen": 231,
  "seen_rate": 0.231,
  "replied": 59,
  "reply_rate": 0.027
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "123456789-987654321",
    "message": "Hey! Just following up.",
    "account_id": "550e8400-e29b-41d4-a716-446655440000"
  }' \
  https://app.scrapely.co/api/v1/dm/send

{
  "success": true,
  "message_id": "1234567890123456789",
  "conversation_id": "123456789-987654321",
  "account_handle": "yourhandle"
}

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/crm/conversations

{
  "columns": {
    "interested_reply": {
      "conversations": [
        {
          "id": "conv-key",
          "conversation_id": "123456-789012",
          "account_handle": "myhandle",
          "tag": "interested_reply",
          "receiver": {
            "screen_name": "lead_handle",
            "name": "Interested Lead",
            "bio": "CEO at...",
            "followers_count": 10000
          },
          "crm": {
            "notes": "Interested in demo",
            "deal_value": 5000,
            "deal_currency": "USD"
          },
          "last_message": {
            "text": "Yes, I'd love to learn more!",
            "time": "2024-01-15T14:30:00Z"
          }
        }
      ],
      "count": 1
    },
    "negative_reply": {
      "conversations": [],
      "count": 0
    }
  },
  "custom_tags": [
    {"id": "uuid", "name": "Hot Lead", "color": "#ff0000", "key": "custom_uuid"}
  ],
  "base_tags": [
    "unread", "interested_reply", "negative_reply", "neutral_reply",
    "engaged", "calendlyd", "booked", "not_interested", "not_qualified"
  ]
}

curl -X PATCH \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "123456-789012",
    "account_handle": "myhandle",
    "notes": "Interested in enterprise plan. Follow up Monday.",
    "deal_value": 10000,
    "deal_currency": "USD",
    "tag": "interested_reply"
  }' \
  https://app.scrapely.co/api/v1/crm/update

{
  "success": true,
  "updated": {
    "conversation_id": "123456-789012",
    "account_handle": "myhandle",
    "notes": "Interested in enterprise plan. Follow up Monday.",
    "deal_value": 10000,
    "deal_currency": "USD",
    "tag": "interested_reply"
  }
}

curl -X POST https://app.scrapely.co/api/v1/people/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bio_contains": ["founder", "ceo"],
    "min_followers": 1000,
    "has_website": true,
    "sort_by": "follower_count",
    "sort_order": "desc",
    "limit": 50
  }'

{
  "rows": [
    {
      "rest_id": "123456789",
      "twitter_handle": "johndoe",
      "name": "John Doe",
      "description": "Founder & CEO @ Acme Corp",
      "website": "https://acme.com",
      "location": "San Francisco, CA",
      "follower_count": 25000,
      "following_count": 1200,
      "profile_image_url": "https://pbs.twimg.com/...",
      "updated_at": "2026-08-30T12:00:00Z"
    }
  ],
  "total": 84320,
  "credits_used": 50,
  "credits_remaining": 9950
}

curl -X POST https://app.scrapely.co/api/v1/people/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bio_contains": ["saas", "b2b"],
    "location_contains": ["new york"],
    "count_only": true
  }'

curl https://app.scrapely.co/api/v1/people/credits \
  -H "X-API-Key: YOUR_API_KEY"

{
  "credits_remaining": 9500,
  "credits_total": 10000,
  "resets_at": "2026-10-01T00:00:00Z"
}

curl https://app.scrapely.co/api/v1/people/schema \
  -H "X-API-Key: YOUR_API_KEY"

{
  "columns": [
    { "name": "rest_id", "type": "String" },
    { "name": "twitter_handle", "type": "String" },
    { "name": "name", "type": "String" },
    { "name": "description", "type": "String" },
    { "name": "follower_count", "type": "UInt64" },
    { "name": "following_count", "type": "UInt64" },
    { "name": "location", "type": "String" },
    { "name": "website", "type": "String" },
    { "name": "profile_image_url", "type": "String" },
    { "name": "profile_banner_url", "type": "String" },
    { "name": "updated_at", "type": "DateTime" },
    { "name": "resolved_website", "type": "String" },
    { "name": "resolved_bio_url", "type": "String" },
    { "name": "resolved_location_url", "type": "String" }
  ]
}

curl -X POST https://app.scrapely.co/api/v1/enrich/twitter \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "companyName": "Acme Corp"
  }'

{
  "matched": true,
  "confidence": 0.92,
  "cached": false,
  "twitter": {
    "handle": "johndoe",
    "user_id": "123456789",
    "name": "John Doe",
    "bio": "Founder @ Acme | Building cool stuff",
    "profile_url": "https://x.com/johndoe",
    "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo_400x400.jpg",
    "followers_count": 5000,
    "following_count": 800,
    "verified": false,
    "location": "San Francisco, CA"
  }
}

{
  "matched": false,
  "confidence": 0.0,
  "cached": false,
  "reason": "no_results"
}

curl -X POST https://app.scrapely.co/api/v1/enrich/email \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "alexhormozi"
  }'

{
  "handle": "alexhormozi",
  "name": "Alex Hormozi",
  "firstName": "Alex",
  "lastName": "Hormozi",
  "fullName": "Alex Hormozi",
  "bio": "Founder @ Acquisition.com | Author of $100M Offers",
  "website": "https://acquisition.com",
  "followers": 500000,
  "domain": "acquisition.com",
  "companyHandle": "acquisition",
  "companyName": "Acquisition.com",
  "email": "alex.hormozi@acquisition.com",
  "emailValidity": "valid"
}

{
  "handle": "someuser",
  "name": "Some User",
  "firstName": "Some",
  "lastName": "User",
  "fullName": "Some User",
  "bio": "Just vibing",
  "website": null,
  "followers": 120,
  "domain": null,
  "companyHandle": null,
  "companyName": null,
  "email": null,
  "emailValidity": null
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/enrich/profile?handle=alexhormozi"

{
  "handle": "AlexHormozi",
  "user_id": "1417686048579018753",
  "name": "Alex Hormozi",
  "bio": "Co-Founder: https://acquisition.com/, https://skool.com/. Business Owners: Get your 2026 free scaling roadmap",
  "bio_urls": ["https://acquisition.com/", "https://skool.com/"],
  "profile_url": "https://x.com/AlexHormozi",
  "profile_image_url": "https://pbs.twimg.com/profile_images/1617408747080667136/C88UDPNZ_400x400.jpg",
  "followers_count": 1082680,
  "following_count": 195,
  "verified": true,
  "location": null
}

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/enrichment/credits

{
  "enrichment_credits": 950,
  "enrichment_credits_used": 50
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "tweet_text": "Just launched a new feature! Check it out",
    "scheduled_at": "2024-03-20T15:00:00Z"
  }' \
  https://app.scrapely.co/api/v1/scheduled-tweets

{
  "success": true,
  "message": "Tweet scheduled successfully",
  "scheduled_tweet": {
    "id": "7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "account_id": "550e8400-e29b-41d4-a716-446655440000",
    "account_handle": "myhandle",
    "tweet_text": "Just launched a new feature! Check it out",
    "scheduled_at": "2024-03-20T15:00:00.000Z",
    "status": "pending",
    "created_at": "2024-03-15T10:30:00.000Z"
  }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/scheduled-tweets?status=pending&limit=10"

{
  "scheduled_tweets": [
    {
      "id": "7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "account_id": "550e8400-e29b-41d4-a716-446655440000",
      "account_handle": "myhandle",
      "account_name": "My Account",
      "account_image": "https://pbs.twimg.com/...",
      "tweet_text": "Just launched a new feature!",
      "scheduled_at": "2024-03-20T15:00:00.000Z",
      "status": "pending",
      "posted_at": null,
      "error_message": null,
      "created_at": "2024-03-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "count": 1,
    "total": 5
  }
}

curl -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tweet_id": "7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
  }' \
  https://app.scrapely.co/api/v1/scheduled-tweets

{
  "success": true,
  "message": "Scheduled tweet cancelled",
  "tweet_id": "7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
}

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/follower-listeners

{
  "listeners": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "target_handle": "naval",
      "listen_followers": true,
      "listen_following": true,
      "is_active": true,
      "followers_checked_at": "2026-10-12T23:51:30.000Z",
      "following_checked_at": "2026-10-12T23:51:30.000Z",
      "last_error": null,
      "created_at": "2026-10-12T20:04:11.000Z"
    }
  ],
  "max": 25
}

curl -X POST "https://app.scrapely.co/api/v1/follower-listeners" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle": "naval", "listen_followers": true, "listen_following": false}'

{
  "listener": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "target_handle": "naval",
    "listen_followers": true,
    "listen_following": true,
    "is_active": true,
    "followers_checked_at": "2026-10-12T23:51:30.000Z",
    "following_checked_at": "2026-10-12T23:51:30.000Z",
    "last_error": null,
    "created_at": "2026-10-12T20:04:11.000Z"
  }
}

curl -X PATCH "https://app.scrapely.co/api/v1/follower-listeners" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "is_active": false}'

curl -X DELETE "https://app.scrapely.co/api/v1/follower-listeners" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"}'

{
  "success": true
}

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://app.scrapely.co/api/v1/follower-listeners/events?target_handle=naval&type=followers&since=2026-10-12&min_followers=1000"

{
  "events": [
    {
      "id": 1042,
      "event": "new_follower",
      "detected_at": "2026-10-12T15:26:32.000Z",
      "listener_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "target_handle": "naval",
      "target_url": "https://x.com/naval",
      "user": {
        "id": "987654321",
        "screen_name": "prospect",
        "name": "John Doe",
        "description": "Founder @acme | Building cool stuff",
        "location": "San Francisco, CA",
        "website": "https://acme.com",
        "followers_count": 4500,
        "following_count": 320,
        "verified": false,
        "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo_normal.jpg",
        "created_at": "2019-04-01T10:00:00.000Z",
        "profile_url": "https://x.com/prospect"
      }
    }
  ],
  "pagination": { "total": 1, "limit": 50, "offset": 0, "has_more": false }
}

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/webhooks

{
  "enabled": true,
  "webhooks": [
    { "url": "https://example.com/scrapely-hook", "has_key": true, "key_preview": "…x9Qa" },
    { "url": "https://hooks.slack.com/services/T000/B000/XXXX", "has_key": false, "key_preview": null }
  ],
  "events": [
    { "name": "new_reply", "description": "A lead replied to your DM for the first time." },
    { "name": "account_disconnected", "description": "One of your X accounts was disconnected and needs attention." }
  ]
}

curl -X POST "https://app.scrapely.co/api/v1/webhooks" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/scrapely-hook", "generate_key": true}'

{
  "webhook": { "url": "https://example.com/scrapely-hook", "has_key": true, "key_preview": "…x9Qa" },
  "key": "whk_3q2v...x9Qa",
  "note": "Save this key now. It will not be shown again."
}

curl -X PATCH "https://app.scrapely.co/api/v1/webhooks" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/scrapely-hook", "generate_key": true}'

curl -X DELETE "https://app.scrapely.co/api/v1/webhooks" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/scrapely-hook"}'

{
  "success": true,
  "url": "https://example.com/scrapely-hook"
}

curl -X PATCH "https://app.scrapely.co/api/v1/webhooks/settings" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

curl -X POST "https://app.scrapely.co/api/v1/webhooks/test" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "results": [
    { "url": "https://example.com/scrapely-hook", "ok": true, "status": 200 },
    { "url": "https://example.com/old-hook", "ok": false, "status": 404, "error": "HTTP 404" }
  ]
}

curl -H "X-API-Key: YOUR_API_KEY" \
  https://app.scrapely.co/api/v1/blocklist?search=johndoe&limit=50

{
  "entries": [
    {
      "rest_id": "16979745",
      "handle": "johndoe",
      "added_by_account_id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2026-08-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "total": 2518,
    "limit": 50,
    "offset": 0
  }
}

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle": "johndoe"}' \
  https://app.scrapely.co/api/v1/blocklist

{
  "success": true,
  "rest_id": "16979745"
}

curl -X DELETE \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle": "johndoe"}' \
  https://app.scrapely.co/api/v1/blocklist

{
  "success": true,
  "cleared": 1
}

curl -X POST "https://app.scrapely.co/api/v1/feedback" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "launch_campaign",
    "what_happened": "Launched a campaign with 3 variants; only the first variant was sent",
    "error_message": "None, returned success"
  }'

{
  "success": true,
  "duplicate": false
}

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

X-Request-ID: req_m1abc123def456
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 105
X-RateLimit-Reset: 1709234567

{
  "error": "Rate limited",
  "message": "Too many requests. Please try again later.",
  "retry_after": 45
}

// Example: incoming webhook request headers
{
  "Content-Type": "application/json",
  "X-Webhook-Key": "your-webhook-secret-value"
}

{
  "event": "new_reply",
  "timestamp": "2024-02-28T12:00:00.000Z",
  "is_back_and_forth": false,

  "conversation_id": "123456789-987654321",
  "unibox_url": "https://app.scrapely.co/unibox?conversation=123456789-987654321",

  "account_twitter_handle": "yourhandle",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",

  "sender_id": "987654321",
  "sender_screen_name": "prospect",
  "message_text": "Hey! I'm interested, let's chat.",
  "message_time": "2024-02-28T12:00:00.000Z",
  "profile_url": "https://x.com/prospect",

  "sentiment": "positive",
  "response_count": 1,

  "lead_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "lead_lead_id": "lead_abc123",
  "lead_twitter_handle": "prospect",
  "lead_name": "John Doe",
  "lead_description": "Founder @acme | Building cool stuff",
  "lead_follower_count": 4500,
  "lead_following_count": 320,
  "lead_location": "San Francisco, CA",
  "lead_website": "https://acme.com",
  "lead_replied": true,
  "lead_replied_at": "2024-02-28T12:00:00.000Z",
  "lead_reply_message": "Hey! I'm interested, let's chat.",
  "lead_reply_sentiment": "positive",
  "lead_created_at": "2024-02-20T08:00:00.000Z",
  "lead_dm_status": "sent",
  "campaign_name": "Founders Import",
  "message_sent": "Hey John, saw you're building Acme...",
  "custom_fields": {
    "first_name": "John",
    "company": "Acme",
    "booking_link": "https://cal.com/yourname/intro"
  },
  "custom_fields_campaign": "Founders Import"
}

{
  "event": "reply_back_and_forth",
  "timestamp": "2024-02-28T14:30:00.000Z",
  "is_back_and_forth": true,

  "conversation_id": "123456789-987654321",
  "unibox_url": "https://app.scrapely.co/unibox?conversation=123456789-987654321",

  "account_twitter_handle": "yourhandle",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",

  "sender_id": "987654321",
  "sender_screen_name": "prospect",
  "message_text": "Sure, how about a call Thursday?",
  "message_time": "2024-02-28T14:30:00.000Z",
  "profile_url": "https://x.com/prospect",

  "sentiment": null,
  "response_count": null,

  "lead_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "lead_lead_id": "lead_abc123",
  "lead_twitter_handle": "prospect",
  "lead_name": "John Doe",
  "lead_description": "Founder @acme | Building cool stuff",
  "lead_follower_count": 4500,
  "lead_following_count": 320,
  "lead_location": "San Francisco, CA",
  "lead_website": "https://acme.com",
  "lead_replied": true,
  "lead_replied_at": "2024-02-28T12:00:00.000Z",
  "lead_reply_message": "Hey! I'm interested, let's chat.",
  "lead_reply_sentiment": "positive",
  "lead_created_at": "2024-02-20T08:00:00.000Z",
  "lead_dm_status": "sent",
  "campaign_name": "Founders Import",
  "message_sent": "Hey John, saw you're building Acme...",
  "custom_fields": {
    "first_name": "John",
    "company": "Acme",
    "booking_link": "https://cal.com/yourname/intro"
  },
  "custom_fields_campaign": "Founders Import"
}

{
  "event": "new_follower",
  "timestamp": "2026-10-12T15:26:32.000Z",
  "listener_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "target_handle": "naval",
  "target_url": "https://x.com/naval",
  "user": {
    "id": "987654321",
    "screen_name": "prospect",
    "name": "John Doe",
    "description": "Founder @acme | Building cool stuff",
    "location": "San Francisco, CA",
    "website": "https://acme.com",
    "followers_count": 4500,
    "following_count": 320,
    "verified": false,
    "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo_normal.jpg",
    "created_at": "2019-04-01T10:00:00.000Z",
    "profile_url": "https://x.com/prospect"
  }
}

{
  "event": "account_disconnected",
  "timestamp": "2024-02-28T12:00:00.000Z",
  "account": {
    "twitter_handle": "yourhandle",
    "account_id": "550e8400-e29b-41d4-a716-446655440000"
  },
  "reason": "cookies_expired"
}

{
  "event": "dm_seen",
  "timestamp": "2024-02-28T13:15:00.000Z",

  "conversation_id": "123456789-987654321",
  "unibox_url": "https://app.scrapely.co/unibox?conversation=123456789-987654321",

  "account_twitter_handle": "yourhandle",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",

  "recipient_id": "987654321",
  "recipient_screen_name": "prospect",
  "profile_url": "https://x.com/prospect",

  "seen_at": "2024-02-28T13:15:00.000Z",

  "lead_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "lead_lead_id": "lead_abc123",
  "lead_twitter_handle": "prospect",
  "lead_name": "John Doe"
}

// Example: verifying the webhook in Node.js
const WEBHOOK_SECRET = process.env.WEBHOOK_SECRET;

function handleWebhook(req, res) {
  const key = req.headers["x-webhook-key"];
  if (key !== WEBHOOK_SECRET) {
    return res.status(403).json({ error: "Forbidden" });
  }

  // Process the webhook payload
  const payload = req.body;
  console.log("Received event:", payload.event);
  res.status(200).json({ received: true });
}

https://mcp.scrapely.co/mcp

claude mcp add --transport http --scope user scrapely https://mcp.scrapely.co/mcp \
  --header "Authorization: Bearer sk_live_your_key_here"

claude mcp remove scrapely --scope user
claude mcp add --transport http --scope user scrapely https://mcp.scrapely.co/mcp \
  --header "Authorization: Bearer sk_live_new_key_here"

https://mcp.scrapely.co/mcp

{
  "mcpServers": {
    "scrapely": {
      "url": "https://mcp.scrapely.co/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

"Show me all my connected accounts"

"Scrape followers of @naval and @paulg, filter for founders with 1k+ followers"

"Launch a campaign called Q1 Outreach targeting my Tech Founders source"

"What are my campaign analytics? Which variant is performing best?"

"Show me all interested replies in the CRM"

"Send a followup to conversation 123456-789012"

"Schedule a tweet from my main account for tomorrow at 9am"

"Find the email for @elonmusk"

"Pause DM sending on my backup account"

Set up the Scrapely CLI for me so you can run Scrapely (my X/Twitter DM outreach tool) from here. Go step by step and tell me what you're doing.

1. Check Node.js with `node --version`. It needs 18.3 or newer. If it's missing or too old, stop and tell me how to install it for my OS.

2. Install the CLI: `npm install -g scrapely-mcp`. Then run `scrapely --version` to confirm. (Note: `npx scrapely` is a different package, never use it.) If the install fails with a permissions error (EACCES), explain the fix for my OS instead of using sudo.

3. Run `scrapely whoami --json`. If I'm not logged in, do NOT ask me for my API key and never let me paste it into this chat. Instead tell me to:
   - create an API key at https://app.scrapely.co/settings/integrations
   - type `! scrapely login` here and paste the key when asked (the input stays hidden)
   Then wait until I say I'm done, and run `scrapely whoami --json` again to confirm. If SCRAPELY_API_KEY is set in my environment with a different key, tell me, because it overrides my login.

4. Run `scrapely setup-agent` (without --yes) to preview the instructions it will install, show me which files it will write, and ask me to confirm. Only after I say yes, run `scrapely setup-agent --yes`.

5. To prove it works, run `scrapely campaigns list --json` and give me a short summary of my campaigns. This only reads data.

6. Finish by telling me: setup is done and only needed once, I should start a new session (`/exit`, then `claude`) so the Scrapely skill loads, and after that I can just ask things like "show me my Scrapely campaigns". Remind me that you'll always show me what you're about to do and wait for my OK before sending DMs, launching or pausing campaigns, or spending credits. Also tell me: when Scrapely announces a new CLI version in the changelog, I update with `npm install -g scrapely-mcp`, then run `scrapely setup-agent`.

npm install -g scrapely-mcp

scrapely login

scrapely setup-agent

scrapely accounts list                          # your connected X accounts
scrapely campaigns list                         # your campaigns and how they're doing
scrapely enrich profile --handle alexhormozi    # any public X profile (free)
scrapely people search --bio-contains founder --min-followers 1000 --count-only   # free count
scrapely --help                                 # everything you can do