Get matches for specific social network group with pagination
GET/search/:searchId/matches/:source
Guest access to already accepted owned searches requires the valid app selector and current owning session even when new guest starts are disabled; bearer account access remains unchanged. Search IDs alone are not credentials.
Returns paginated matches for a specific social network group using cursor-based pagination.
Important: This endpoint is only available before matches are selected. Once matches are selected via POST /search/{searchId}/select, this endpoint returns 400 error. After selection, use GET /search/{searchId}/results to view selected match.
Cursor-based pagination:
- First request: omit
cursorparameter to get the first page - Subsequent requests: use
nextCursorfrom previous response ascursorparameter - If
nextCursoris null in response, there are no more matches available
Request
Responses
- 200
- 400
- 401
- 404
- 409
- 500
- 503
Matches for specific social network group
Bad request - matches already selected. Selection cannot be changed after credit is deducted.
Unauthorized
Not found
App-session guest pending outcome. GeneralError.message is guest_attempt_pending (retryable unfinished attempt) or session_transition_pending (retryable verified-account handoff). An unfinished attempt cannot create a second accepted Search. For authenticated multipart upload, 409 also covers an unfinished account attempt, a same-account/key collision between multipart and direct upload, or replay of a soft-deleted accepted Search. A deleted Search keeps its key consumed; the response discloses no deleted Search data and creates no new reservation. Pending attempts may be retried with the same key.
Response Headers
Seconds to wait before retrying a pending attempt or transition.
Internal server error
Canonical session identity, transaction or admission storage unavailable. Guest requests fail closed instead of receiving a new session or quota. For authenticated multipart upload, infrastructure failure or an uncertain admission outcome also returns 503. Retry with the same account and Idempotency-Key; uncertainty must not create a second accepted Search.