Skip to main content
POST
Discover Intelligence

Request contract

  • Method and path: POST /apis/v1/predict-leads/discover-intelligence
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/predict-leads/discover-intelligence
  • Runtime facts: e0bd07e632ad90107c78fe3e2a0a8c42a327ecc682d82122d9d5e59d5ffc93e3
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0403 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0403
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 10000000
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

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

Body

application/json
limit
integer
required

Maximum records on this page (1-1000). Charged per returned record, so the conservative default is 5.

Required range: 1 <= x <= 100
dataset
enum<string>
required

Cross-company intelligence dataset to discover from one fixed endpoint.

Available options:
job_openings,
technology_detections,
news_events,
financing_events,
investor_connections,
products,
startup_platform_posts
page
integer
default:1

Provider page number, starting at 1. Always sent to obtain count metadata.

Required range: x >= 1
title
string

Job title filter. Valid only for job_openings.

location
string

Job location for job_openings, or company location for news_events and financing_events.

date_from
string<date>

Date start: first_seen_at for jobs, technology detections, or investor connections, and published_at for startup posts.

Example:

"2026-01-01"

seniority
enum<string>

Job seniority filter. Valid only for job_openings.

Available options:
not_set,
founder,
c_level,
partner,
president,
vice_president,
head,
director,
manager,
mid_senior,
junior
date_until
string<date>

Date end for technology detections, investor connections, or startup posts. Jobs do not support an end date.

Example:

"2026-01-31"

onet_codes
string[]

O*NET occupation codes for job_openings only. Accepts an array or comma-separated string and sends one CSV query value.

post_types
enum<string>[]

Startup post types, show_hn or job_hn, for startup_platform_posts only. Accepts an array or comma-separated string and sends one CSV query value.

Available options:
show_hn,
job_hn
active_only
boolean

Return active jobs only. Valid only for job_openings.

company_sizes
enum<string>[]

Company size bands for news_events only. Accepts an array or comma-separated string and sends one CSV query value.

Available options:
1,
2-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
news_categories
string[]

News-event categories, such as launches, hires, or receives_financing. Valid only for news_events and sent as one CSV query value.

last_seen_at_from
string<date>

Last-seen start date for technology detections or investor connections.

last_seen_at_until
string<date>

Last-seen end date for technology detections or investor connections. Must not precede last_seen_at_from.

product_categories
string[]

Product categories: product, service, solution, or unclassified. Valid only for products and sent as one CSV query value.

product_subcategories
string[]

Product subcategories only: industry, use_case, pricing_tier, or unclassified. Sent as one CSV query value.

financing_types_normalized
string[]

Normalized financing round types for financing_events only. Accepts an array or comma-separated string and sends one CSV query value.

technology_id_or_fuzzy_name
string

PredictLeads technology ID or fuzzy name. Required only for technology_detections and rejected for every other dataset.

Example:

"Salesforce"

Response

Tool result data

dataset
enum<string>
required
Available options:
job_openings,
technology_detections,
news_events,
financing_events,
investor_connections,
products,
startup_platform_posts
data
object[]
meta
object
included
object[]