Travel & communities
Couchsurfing API
Read public Couchsurfing member profiles, community events and the upcoming events of a city with source fields preserved.
Retrieve public Couchsurfing profiles, events and location information, with identifiers, images and structured records.
API availability: Available
http://localhost:3018Public API: https://api.scrapeatlas.com.Endpoints
/v1/couchsurfing/profileGet a Couchsurfing profile
Retrieve one public member profile by handle: identity, about text, home and travel locations, languages, interests, photos, legacy profile answers, friend count and published prompt answers.
Reference/v1/couchsurfing/eventGet a Couchsurfing event
Retrieve one public community event (hangout) by URL: title, description, schedule, activity, venue with coordinates and map link, cover image, recurrence, organizer summaries, participation counters and the public interested/attending previews.
Reference/v1/couchsurfing/eventsList Couchsurfing events by location
List the upcoming public events embedded in a Couchsurfing location page, together with the location's published summary, statistics and FAQ, and the source total.
ReferenceQuick start
Create an API key on your account page, then call the public API. Values below are placeholders.
curl "https://api.scrapeatlas.com/v1/couchsurfing/profile?handle=Couchsurfing" \
-H "x-api-key: YOUR_API_KEY"Coverage & limits
- Independent stateless worker, port 3018, COUCHSURFING_API_KEY in x-api-key. No database, login, browser, cookies, proxy or result storage.
- Four concurrent requests, 20-second deadline, two upstream attempts including one transient retry. Challenges and 429 responses are not retried. Redirects are rejected.
- Fixed www.couchsurfing.com HTTPS origin under /c/. At most 8 MiB decoded HTML, 200,000 parsed nodes, depth 32 and 100 records per array. No scripts, media or outbound links are fetched.
- Public page state: layout changes are reported as explicit unsupported_page failures rather than guessed. No credentials, session cookies or private endpoints are used.
- Private profiles fail with restricted; deleted records fail with not_found.
- Location events: the embedded page of events with the source total; interested and attending lists are the page previews, marked attendee_preview_only. Counters are source values.
- Viewer-relative fields (friend and block status, mutual counts, current-user flags), locale settings, raw participant join records and geospatial index cells are excluded.
| HTTP | failure.code | Meaning |
|---|---|---|
| 200 | partial | Usable page data with explicit coverage warnings. |
| 400 | invalid_request | Missing, duplicate, unsupported or malformed parameters. |
| 401 | unauthorized | Missing or invalid service key. |
| 403 | restricted | Private member profile. |
| 404 | not_found | Missing or deleted profile, event or location. |
| 429 | upstream_rate_limited | Source throttled retrieval. |
| 502 | upstream_challenged | The source challenged the request. |
| 502 | unsupported_page | Missing, malformed or mismatched structured page state. |
| 502 | response_too_large payload_too_complex | Byte, node or depth limit exceeded. |
| 502 | unsafe_redirect request_limit upstream_error | Bounded retrieval failed. |
| 503 | busy | All slots are occupied. |
| 504 | timeout | Deadline expired. |
