scraper-api-com Bumble API
Bumble: 0 public endpoints, no account needed, plus 9 signed-in routes (login, logout, messages, account, search, profile, like, matches, challenge) behind an `x-session-id`.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/scraper-api-com:scraper-api-com-bumble-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: scraper-api.com Bumble API
version: 0.1.0
description: 'Self-hosted social media scraping API — a drop-in replacement for scrapecreators.com.
## Authentication
Every request must send your API key in the `x-api-key` header.
## Credits
Billing is credit-based: **1 request = 1 credit** (some endpoints cost more — see each endpoint''s description). Credits are **non-expiring** — buy once, use whenever.
Response bodies match the ScrapeCreators shapes so existing integrations work unchanged.'
contact:
name: Fabian Bitter
email: fabian@bitter.de
servers:
- url: https://api.scraper-api.com
description: Production
security:
- apiKeyAuth: []
tags:
- name: Bumble
description: 'Bumble: 0 public endpoints, no account needed, plus 9 signed-in routes (login, logout, messages, account, search, profile, like, matches, challenge) behind an `x-session-id`.'
paths:
/v1/bumble/login:
post:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_login
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters: []
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
session_id: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
user_id: name@example.com
expires_at: '2026-08-09T22:02:00.000Z'
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
username:
type: string
description: The portal account's e-mail address, or its phone number in +49… form where the platform signs in with one.
example: name@example.com
password:
type: string
description: The portal account's password, or the one-time code where the platform has no password.
example: •••••••••
login_token:
type: string
description: The token the challenge route handed back, which binds the code to the attempt it was sent for. On a portal that only asks for a code when it does not recognise the sign-in, this carries that mailed code itself.
example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…
required:
- username
- password
example:
username: name@example.com
password: •••••••••
/v1/bumble/logout:
post:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_logout
description: '**Live endpoint.** Free of charge.'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example: null
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
/v1/bumble/messages:
get:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_messages
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
- name: conversation_id
in: query
required: false
description: One conversation of the inbox. Omit to list the inbox.
schema:
type: string
example: '412778905'
- name: limit
in: query
required: false
description: How many members one page holds.
schema:
type: string
example: '20'
- name: cursor
in: query
required: false
description: Continue after the previous page. Take it from `next_cursor` of the answer.
schema:
type: string
example: eyJvZmZzZXQiOjIwfQ
- name: archived
in: query
required: false
description: Read the archived conversations instead of the current inbox.
schema:
type: string
enum:
- 'true'
- 'false'
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
count: 1
next_cursor: null
conversations:
- conversation_id: '412778905'
partner: Lea
partner_photo: https://…/1.jpg
last_message: Klingt gut, wann passt es dir?
last_message_at: '2026-08-08T18:24:00.000Z'
unread: true
unread_count: 1
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
post:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_messages_send
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
conversation_id: '412778905'
data:
delivered: true
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: The message text.
example: Ist der Artikel noch verfuegbar?
conversation_id:
type: string
description: One conversation of the inbox. Omit to list the inbox.
example: '412778905'
user_id:
type: string
description: The other member's id on the platform.
example: '12345678'
required:
- message
example:
message: Ist der Artikel noch verfuegbar?
/v1/bumble/account:
get:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_account
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
- name: id
in: query
required: false
description: Another member's public id. Omit for the signed-in account's own profile.
schema:
type: string
example: e63599e304f57gf2efi03735d45g21h6
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
data:
id: '12345678'
name: Lea
age: 29
gender: female
city: Bochum
distance_km: 12
online: true
last_seen: '2026-08-09T09:12:00.000Z'
about: Ich koche gern und laufe noch lieber.
photos:
- https://…/1.jpg
- https://…/2.jpg
attributes:
height: '168'
smoker: 'no'
relationship: single
liked_by_me: false
likes_me: null
matched: false
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
/v1/bumble/search:
get:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_search
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
- name: min_age
in: query
required: false
description: Youngest age to include.
schema:
type: string
example: '25'
- name: max_age
in: query
required: false
description: Oldest age to include.
schema:
type: string
example: '40'
- name: distance
in: query
required: false
description: Search radius in kilometres around the account's location.
schema:
type: string
example: '50'
- name: with_photo
in: query
required: false
description: Only members who have at least one photo.
schema:
type: string
enum:
- 'true'
- 'false'
- name: limit
in: query
required: false
description: How many members one page holds.
schema:
type: string
example: '20'
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
count: 1
next_cursor: null
members:
- id: '12345678'
name: Lea
age: 29
gender: female
distance_km: 12
online: true
city: Bochum
headline: Lieber ein Kaffee zu viel als ein Gespraech zu wenig.
photos:
- https://…/1.jpg
url: https://…/12345678
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
/v1/bumble/profile:
get:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_profile
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
- name: user_id
in: query
required: true
description: The other member's id on the platform.
schema:
type: string
example: '12345678'
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
data:
id: '12345678'
name: Lea
age: 29
gender: female
city: Bochum
distance_km: 12
online: true
last_seen: '2026-08-09T09:12:00.000Z'
about: Ich koche gern und laufe noch lieber.
photos:
- https://…/1.jpg
- https://…/2.jpg
attributes:
height: '168'
smoker: 'no'
relationship: single
liked_by_me: false
likes_me: null
matched: false
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
/v1/bumble/like:
post:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_like
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
user_id: '12345678'
action: LIKE
matched: false
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
user_id:
type: string
description: The other member's id on the platform.
example: '12345678'
action:
type: string
description: What to do with that member. UNLIKE takes a like back where the platform allows it; PASS is the swipe-away.
enum:
- LIKE
- SUPERLIKE
- PASS
- UNLIKE
message:
type: string
description: The message text.
example: Ist der Artikel noch verfuegbar?
required:
- user_id
example:
user_id: '12345678'
/v1/bumble/matches:
get:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_matches
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters:
- name: x-session-id
in: header
required: true
description: The session id returned by login. Sent as the x-session-id header.
schema:
type: string
example: b6f0a1c2d3e4f5a6b7c8d9e0f1a2b3c4
- name: limit
in: query
required: false
description: How many members one page holds.
schema:
type: string
example: '20'
- name: cursor
in: query
required: false
description: Continue after the previous page. Take it from `next_cursor` of the answer.
schema:
type: string
example: eyJvZmZzZXQiOjIwfQ
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
count: 1
next_cursor: null
matches:
- id: '77123'
user_id: '12345678'
name: Lea
photo: https://…/1.jpg
matched_at: '2026-08-08T21:03:00.000Z'
conversation_id: '77123'
unread: true
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
/v1/bumble/challenge:
post:
tags:
- Bumble
summary: 'NOT AVAILABLE: Bumble retired the API these routes speak.'
operationId: bumble_v1_challenge
description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
security:
- apiKeyAuth: []
parameters: []
responses:
'200':
description: Platform-native JSON payload (ScrapeCreators-compatible).
content:
application/json:
example:
success: true
channel: sms
login_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…
code_length: 6
sent: true
'400':
description: Missing or invalid parameters.
content:
application/json:
example:
error:
message: 'Missing required parameter(s): handle'
'401':
description: Missing or invalid API key.
content:
application/json:
example:
error:
message: Invalid API key.
'402':
description: Not enough credits.
content:
application/json:
example:
error:
message: Insufficient credits.
'429':
description: Rate limit exceeded.
content:
application/json:
example:
error:
message: Rate limit exceeded.
'502':
description: Upstream scrape failed.
content:
application/json:
example:
error:
message: Upstream scrape failed.
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
username:
type: string
description: The portal account's e-mail address, or its phone number in +49… form where the platform signs in with one.
example: name@example.com
login_token:
type: string
description: The token the challenge route handed back, which binds the code to the attempt it was sent for. On a portal that only asks for a code when it does not recognise the sign-in, this carries that mailed code itself.
example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…
captcha_token:
type: string
description: reCAPTCHA token, where the portal's form demands one.
example: 03AGdBq26…
captcha_reference:
type: string
description: The reference the portal issued together with that bot check. Tinder verifies the solved token against it, so a token without it is never checked.
example: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9…
required:
- username
example:
username: name@example.com
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Your scraper-api.com API key.
x-tagGroups:
- name: Platforms
tags:
- Instagram
- TikTok
- YouTube
- Facebook
- LinkedIn
- Twitter
- Spotify
- Apple Music
- Kleinanzeigen
- Quoka
- markt.de
- mobile.de
- '11880'
- Gelbe Seiten
- ImmobilienScout24
- immowelt
- WG-Gesucht
- Bayut
- LOVOO
- Jaumo
- Tinder
- Bumble
- Snapchat
- Google
- Arbeitsagentur
- Ausbildung.de
- meinestadt.de