cURL
curl --request GET \ --url https://api.search.tinyfish.ai/v1/search/usage \ --header 'X-API-Key: <api-key>'
{ "items": [ { "id": 1, "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "query": "web automation tools", "status_code": 200, "result_count": 10, "results": [ { "position": 1, "site_name": "example.com", "snippet": "Top web automation tools for 2026...", "title": "Best Web Automation Tools", "url": "https://example.com/web-automation-tools" } ], "cached": null, "response_size_bytes": 4096, "created_at": "2026-01-14T10:30:00Z" } ], "total": 1, "limit": 100, "page": 1, "total_pages": 1, "has_more": false }
List search usage records for the authenticated user. Returns paginated results with query details, status, and result counts.
API key for authentication. Get your key from the API Keys page.
completed
failed
1 <= x <= 1000
x >= 1
Search usage retrieved successfully.
Paginated search usage response
Show child attributes
Was this page helpful?