curl --request POST \
--url https://api.goldilocksai.app/searches/{search_id}/more-profiles \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"profiles_requested": 20
}
'
{
"success": true,
"data": {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"search_id": "d7b7e1e3-2136-4eb4-872a-8c6dd265d518",
"created_at": "2025-12-23T10:30:00.000Z",
"user_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "IN_PROGRESS",
"profiles_requested": 20
},
"metadata": null,
"error": null,
"request_id": "abc12345-e89b-12d3-a456-426614174000",
"processing_time_ms": 75
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "INVALID_INPUT",
"message": "Your request contains invalid data. Please check your input and try again.",
"details": {
"field": "query",
"error": "Field is required"
}
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 50
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "UNAUTHORIZED",
"message": "Missing or invalid API key"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 20
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "FORBIDDEN",
"message": "Access denied. You don't have permission to access this resource."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 30
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Search not found or you don't have access to it"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 40
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Please wait before making another request."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 10
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred. Please try again later."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 100
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Service temporarily unavailable. Please retry your request."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 200
}Searches
More Profiles
Fetch additional profiles for an existing search when you need more results. This endpoint uses the same search context and criteria as your original search to find additional relevant profiles. The process runs asynchronously, and once complete, the new profiles are automatically merged with your existing results. You can request between 1-200 additional profiles per call.
POST
/
searches
/
{search_id}
/
more-profiles
curl --request POST \
--url https://api.goldilocksai.app/searches/{search_id}/more-profiles \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"profiles_requested": 20
}
'
{
"success": true,
"data": {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"search_id": "d7b7e1e3-2136-4eb4-872a-8c6dd265d518",
"created_at": "2025-12-23T10:30:00.000Z",
"user_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "IN_PROGRESS",
"profiles_requested": 20
},
"metadata": null,
"error": null,
"request_id": "abc12345-e89b-12d3-a456-426614174000",
"processing_time_ms": 75
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "INVALID_INPUT",
"message": "Your request contains invalid data. Please check your input and try again.",
"details": {
"field": "query",
"error": "Field is required"
}
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 50
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "UNAUTHORIZED",
"message": "Missing or invalid API key"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 20
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "FORBIDDEN",
"message": "Access denied. You don't have permission to access this resource."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 30
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Search not found or you don't have access to it"
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 40
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Please wait before making another request."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 10
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred. Please try again later."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 100
}{
"success": false,
"data": null,
"metadata": null,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Service temporarily unavailable. Please retry your request."
},
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"processing_time_ms": 200
}Authorizations
API key for authentication. Obtain your API key via the web application.
Path Parameters
Unique identifier of the existing search
Body
application/json
Request body for fetching more profiles for an existing search
Number of additional profiles to fetch (1-200)
Required range:
1 <= x <= 200Example:
20
⌘I
