{"skill":{"slug":"scrapebadger","displayName":"ScrapeBadger","summary":"Web scraping platform — Twitter/X data, Vinted marketplace, and general web scraping API","description":"---\nname: scrapebadger\ndescription: Web scraping platform — Twitter/X data, Vinted marketplace, and general web scraping API\nversion: 1.0.0\nrequires:\n  env:\n    - SCRAPEBADGER_API_KEY\ntags:\n  - twitter\n  - vinted\n  - web-scraping\n  - scraping\n  - social-media\n  - marketplace\n  - api\n  - data\n---\n\n# ScrapeBadger — Web Scraping Platform\n\nScrapeBadger provides REST APIs for three products. Use the `web_fetch` tool to call these endpoints.\n\n## Authentication\n\nEvery request needs the `SCRAPEBADGER_API_KEY` environment variable.\nInclude it as an HTTP header: `X-API-Key: $SCRAPEBADGER_API_KEY`\n\n## Base URL\n\n```\nhttps://scrapebadger.com\n```\n\n---\n\n## Twitter/X API\n\n### Users\n\n**Get user profile by username:**\n```\nGET /v1/twitter/users/{username}/by_username\n```\n\n**Get user profile by numeric ID:**\n```\nGET /v1/twitter/users/{user_id}/by_id\n```\n\n**Batch get users by usernames (comma-separated):**\n```\nGET /v1/twitter/users/batch_by_usernames?usernames=elonmusk,OpenAI\n```\n\n**Batch get users by IDs (comma-separated):**\n```\nGET /v1/twitter/users/batch_by_ids?user_ids=44196397,1230113324\n```\n\n**Search users:**\n```\nGET /v1/twitter/users/search_users?query=AI+agents\n```\n\n**Get followers:**\n```\nGET /v1/twitter/users/{username}/followers\n```\n\n**Get following:**\n```\nGET /v1/twitter/users/{username}/followings\n```\n\n**Get mentions:**\n```\nGET /v1/twitter/users/{username}/mentions\n```\n\n**Get subscriptions:**\n```\nGET /v1/twitter/users/{user_id}/subscriptions\n```\n\n**Get user articles:**\n```\nGET /v1/twitter/users/{user_id}/articles\n```\n\n### Tweets\n\n**Get tweet by ID:**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}\n```\n\n**Get multiple tweets by IDs:**\n```\nGET /v1/twitter/tweets/?tweets=123,456,789\n```\n\n**Advanced search:**\n```\nGET /v1/twitter/tweets/advanced_search?query=web+scraping&query_type=Latest&count=20\n```\n\n**Get replies:**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}/replies\n```\n\n**Get quotes:**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}/quotes\n```\n\n**Get retweeters:**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}/retweeters\n```\n\n**Get favoriters (likes):**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}/favoriters\n```\n\n**Get similar tweets:**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}/similar\n```\n\n**Get edit history:**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}/edit_history\n```\n\n**Get community notes:**\n```\nGET /v1/twitter/tweets/tweet/{tweet_id}/community_notes\n```\n\n**Get article:**\n```\nGET /v1/twitter/tweets/article/{article_id}\n```\n\n### Communities\n\n**Get community:**\n```\nGET /v1/twitter/communities/{community_id}\n```\n\n**Get community tweets:**\n```\nGET /v1/twitter/communities/{community_id}/tweets\n```\n\n**Search communities:**\n```\nGET /v1/twitter/communities/search?query=AI\n```\n\n### Lists\n\n**Get list details:**\n```\nGET /v1/twitter/lists/{list_id}/detail\n```\n\n**Get list tweets:**\n```\nGET /v1/twitter/lists/{list_id}/tweets\n```\n\n**Search tweets in list:**\n```\nGET /v1/twitter/lists/{list_id}/search_tweets?query=keyword\n```\n\n### Trends\n\n**Get trending topics:**\n```\nGET /v1/twitter/trends/\n```\n\n**Get trends by location (WOEID):**\n```\nGET /v1/twitter/trends/place/{woeid}\n```\n\n### Geo\n\n**Search places:**\n```\nGET /v1/twitter/geo/search?query=New+York\n```\n\n**Get place details:**\n```\nGET /v1/twitter/geo/places/{place_id}\n```\n\n### Spaces\n\n**Get Space details:**\n```\nGET /v1/twitter/spaces/{space_id}\n```\n\n**Get broadcast details:**\n```\nGET /v1/twitter/spaces/broadcast/{broadcast_id}\n```\n\n---\n\n## Vinted Marketplace API\n\n**Search items:**\n```\nGET /v1/vinted/search?query=nike+shoes&market=fr&page=1&per_page=20\n```\nOptional params: `price_from`, `price_to`, `brand_ids`, `order`\n\n**Get item details:**\n```\nGET /v1/vinted/items/{item_id}?market=fr\n```\n\n**Get user profile:**\n```\nGET /v1/vinted/users/{user_id}?market=fr\n```\n\n**Get user's items:**\n```\nGET /v1/vinted/users/{user_id}/items?market=fr\n```\n\n**Search brands:**\n```\nGET /v1/vinted/brands?keyword=nike&market=fr\n```\n\n**List colors:**\n```\nGET /v1/vinted/colors?market=fr\n```\n\n**List statuses:**\n```\nGET /v1/vinted/statuses?market=fr\n```\n\n**List markets:**\n```\nGET /v1/vinted/markets\n```\n\nSupported markets: fr, de, uk, us, es, it, nl, be, at, pl, pt, cz, lt, and more.\n\n---\n\n## Web Scraping API\n\n**Scrape a URL:**\n```\nPOST /v1/web/scrape\nContent-Type: application/json\n\n{\"url\": \"https://example.com\", \"render_js\": false, \"return_format\": \"markdown\"}\n```\nOptional fields: `render_js` (boolean), `wait_for` (CSS selector), `timeout_ms`, `proxy_country`, `return_format` (html/markdown/text)\n\n**Detect anti-bot protection (1 credit):**\n```\nPOST /v1/web/detect\nContent-Type: application/json\n\n{\"url\": \"https://example.com\"}\n```\n\n**Take screenshot:**\n```\nPOST /v1/web/screenshot\nContent-Type: application/json\n\n{\"url\": \"https://example.com\", \"full_page\": true}\n```\n\n**Extract structured data:**\n```\nPOST /v1/web/extract\nContent-Type: application/json\n\n{\"url\": \"https://example.com\", \"ai_query\": \"What is the main product price?\"}\n```\nOptional fields: `extract_rules` (CSS/XPath), `ai_extract_rules`, `ai_query`\n\n**Submit batch job:**\n```\nPOST /v1/web/batch\nContent-Type: application/json\n\n{\"urls\": [\"https://example.com\", \"https://example.org\"]}\n```\n\n**Check batch status:**\n```\nGET /v1/web/batch/{job_id}\n```\n\n---\n\n## Pagination\n\nMost list endpoints support cursor-based pagination. Pass the `cursor` query parameter from the previous response to get the next page.\n\n## Credits\n\nEach API call costs credits. Check your balance:\n- Twitter endpoints: 1 credit per call\n- Web scraping: 1-10 credits depending on complexity\n- Vinted: 1 credit per call\n\n## Rate Limits\n\nRate limits are per API key. Check the `X-RateLimit-*` response headers for current limits.\n\n## More Information\n\n- Documentation: https://docs.scrapebadger.com\n- Dashboard: https://scrapebadger.com/dashboard\n- MCP Server: https://mcp.scrapebadger.com/mcp\n","tags":{"api":"1.0.0","latest":"1.0.0","scraping":"1.0.0","twitter":"1.0.0","vinted":"1.0.0","web-scraping":"1.0.0"},"stats":{"comments":0,"downloads":405,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1775488925190,"updatedAt":1778492444420},"latestVersion":{"version":"1.0.0","createdAt":1775488925190,"changelog":"Initial release — Twitter/X, Vinted, and Web Scraping API skill","license":"MIT-0"},"metadata":{"setup":[{"key":"SCRAPEBADGER_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"0xghostcasper","userId":"s1768mx70e751026phskqnyw0d84bj7a","displayName":"0xGhostCasper","image":"https://avatars.githubusercontent.com/u/125361508?v=4"},"moderation":null}