Skip to main content
GET
/
api
/
leads
/
search
List recent lead searches
curl --request GET \
  --url https://app.puffle.ai/api/leads/search \
  --header 'Authorization: Bearer <token>'
{
  "searches": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "title_edited": true,
      "status": "pending",
      "filters": {},
      "apify_run_id": "<string>",
      "result_count": 4503599627370495,
      "error_message": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ]
}

​
Overview

Return the 20 most-recent lead_searches rows owned by the authenticated user, newest first. Intended for UI history / agent memory — not for bulk iteration.
This operation shares the URL path /api/leads/search with other verbs. See the sibling page for related operations on the same resource.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Up to 20 most-recent searches.

Most-recent 20 searches for the caller, newest first. No pagination — the list view is intended for a sidebar, not bulk iteration.

​
searches
object[]
required