Get Account Search Results

Get search results

Retrieve completed search results from a job.

Required Headers:

• X-API-Key: Your API key
• X-User-ID: Your email/user ID

Path Parameters:

• job_id: Job ID returned from start-search-job

Response:

• job_id: The job ID
• status: Job status (“completed”)
• results: Array of matching accounts
• total_count: Total number of results

Result Account Fields:

• rank: Rank in search results (1 = best match)
• account_id: Internal account ID
• account_name: Company name
• account_url: Company website
• user_email: User who owns this account
• employee_count: Number of employees
• funding_stage: Funding stage (e.g., “Series B”)
• location: Company location
• reasoning: Why this account matches the query
• evidence_snippets: Supporting evidence quotes
• relevance_score: Relevance score (0-10)

Requirements:

• Job must be in “completed” status
• Use poll-search-job first to ensure job is completed

Example Request:

GET /api/v1/account/get-search-results/550e8400-e29b-41d4-a716-446655440000
Headers:
  X-API-Key: your_api_key
  X-User-ID: [email protected]

Error Responses:

• 400: Job not completed (status is pending/running/failed)
• 404: Job not found or doesn’t belong to user