Search, filter, and browse your request history. Supports three modes:

1. Semantic Search (query, image_url, or video_url parameter): Find visually or conceptually similar results using AI embeddings. Provide a text query for text-to-image search, an image URL for image-to-image similarity search, or a video URL for video-to-image similarity search.

2. Filtered Browse (no query, image_url, or video_url): Browse request history with hard filters. Returns results ordered by creation date (newest first).

3. Semantic + Filters (search params AND filter params): Combine semantic search with hard filters. Filters narrow the candidate set before ranking by similarity.

Filter Options:

• endpoint_id: Filter by one or more fal endpoints (comma-separated or repeated, up to 50 IDs)
• exclude_api_requests / only_api_requests: Filter by request source

Examples:

• Semantic text search: ?query=sunset+landscape
• Image similarity: ?image_url=https://...&min_similarity=0.5
• Filtered search: ?query=portrait&endpoint_id=fal-ai/flux/dev
• Browse across multiple endpoints: ?endpoint_id=fal-ai/flux/dev,fal-ai/flux/schnell

Required permissions: models:requests:read. Key presets that include them: API, SERVERLESS, READONLY, FULL. See key permissions.

{
  "results": [
    {
      "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "endpoint_id": "fal-ai/flux/dev",
      "started_at": "2025-01-01T00:00:05Z",
      "sent_at": "2025-01-01T00:00:01Z",
      "ended_at": "2025-01-01T00:00:08Z",
      "status_code": 200,
      "duration": 7.8,
      "similarity": 0.87
    }
  ]
}