Title78/100
Create a Deep Research request
Align the title with the capability actually described by this tool.
Description91/100
Useful when the user wants new B2B leads: companies that match an ideal customer profile (ICP), with the right contacts at each. Starts a lead request: Leadpoet researches companies and contacts that match the targeting and delivers them to Pipeline, with a typical turnaround of 1–2 days. Reserves credits. With recurrence, also schedules paid repeats that add contacts to a campaign. Retrying with the same idempotencyKey and input returns the first result instead of repeating the action.
The description explains the capability, when to use it, and what to expect.
Inputs19/100
11 of 47 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
body › supplied_companies › allOf › 1 › items › company_name
Not provided
Missing description. Explain what this value means and how to supply it.
body › supplied_companies › allOf › 1 › items › domain
Not provided
Missing description. Explain what this value means and how to supply it.
body › supplied_companies › allOf › 1 › items › linkedin_url
Not provided
Missing description. Explain what this value means and how to supply it.
body › contact_methods › email
Not provided
Missing description. Explain what this value means and how to supply it.
body › contact_methods › linkedin
Not provided
Missing description. Explain what this value means and how to supply it.
body › contact_methods › phone
Not provided
Missing description. Explain what this value means and how to supply it.
body › phone_enrichment_included
Copy phone_enrichment_included from GET /requests/contact-settings. Required when contact_methods.phone is true.
Resolve the mismatch between this description and its schema constraints.
body › contacts_per_company
Contacts to deliver per company. Each contact above included_contacts_per_company costs pricing.credits_per_extra_contact per company.
Clear enough to supply this argument.
body › included_contacts_per_company
Copy included_contacts_per_company from GET /requests/contact-settings. A stale value returns 409 contact_allowance_changed.
Clear enough to supply this argument.
body › lead_type
Not provided
Missing description. Explain what this value means and how to supply it.
body › request_description
Required for company requests: the companies to find, with every industry, size, place and trait the user named.
Clear enough to supply this argument.
body › product_description
Required for company requests: what the user sells, from their saved product or ICP.
Clear enough to supply this argument.
body › intent_signals
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › schema_version
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › bindings › items › role
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › bindings › items › definition › allOf › 1 › schema_version
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › bindings › items › definition › allOf › 1 › archetype_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › bindings › items › definition › allOf › 1 › signal_kind_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › bindings › items › definition › allOf › 1 › signal_kind_version
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › bindings › items › definition › allOf › 1 › parameters
Not provided
Missing description. Explain what this value means and how to supply it.
body › signal_profile › bindings › items › definition › allOf › 1 › max_age_days
Not provided
Missing description. Explain what this value means and how to supply it.
body › max_leads
Number of companies. A paid request takes 10 to 100; a supplied list uses its own length, which must also be 10 to 100 distinct companies, and the free-lead offer takes 1.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
body › countries
Full country names, for example "United States".
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
body › states
Not provided
Missing description. Explain what this value means and how to supply it.
body › cities
Not provided
Missing description. Explain what this value means and how to supply it.
body › company_sizes
App size labels: "<10 employees", "10–50 employees", "50–200 employees", "200–500 employees", "500–1,000 employees", "1,000–5,000 employees", "5,000–10,000 employees" or "10,000+ employees".
Clear enough to supply this argument.
body › filters
Not provided
Missing description. Explain what this value means and how to supply it.
body › credit_budget
With contacts_per_company, the exact total for a paid request: max_leads × (credits_per_company + credits_per_extra_contact × extra contacts per company + credits_per_mobile_contact × contacts_per_company when contact_methods.phone is true), from GET /requests/contact-settings pricing. Example: 10 companies with 2 contacts each and 1 included cost 150 credits. Without contacts_per_company, credit_budget / 10 sets the number of companies. A paid request needs at least 10 companies (100 credits with included contacts); a supplied list is priced by its length. A paid request must leave at least 100 credits, or less than its own price per company (the company plus its extra contacts and mobile numbers). The free-lead offer instead sends funding_source "free_lead_promotion", free_lead_entitlement_id, max_leads 1 and credit_budget 10.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
body › funding_source
Not provided
Missing description. Explain what this value means and how to supply it.
body › free_lead_entitlement_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › signup_credit_grant › device_token
Not provided
Missing description. Explain what this value means and how to supply it.
body › signup_credit_grant › turnstile_token
Not provided
Missing description. Explain what this value means and how to supply it.
body › require_phone
Not provided
Missing description. Explain what this value means and how to supply it.
body › requested_roles
The contact titles to find at each company, such as the ones the user named.
Clear enough to supply this argument.
body › natural_language_query
Not provided
Missing description. Explain what this value means and how to supply it.
body › naturalLanguageQuery
Not provided
Missing description. Explain what this value means and how to supply it.
body › icp_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › saved_product › product_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › saved_product › version_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › icp_name
Not provided
Missing description. Explain what this value means and how to supply it.
body › query_details
Not provided
Missing description. Explain what this value means and how to supply it.
body › queryDetails
Not provided
Missing description. Explain what this value means and how to supply it.
body › website_scan_application › scan_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › website_scan_application › product_id
Not provided
Missing description. Explain what this value means and how to supply it.
body › website_scan_application › reviewed
Not provided
Missing description. Explain what this value means and how to supply it.
body › website_scan_application › segment_id
Not provided
Missing description. Explain what this value means and how to supply it.
idempotencyKey
A unique key for this action. Reuse it only to retry the same call with the same input; use a new key for a new action.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Create a Deep Research request",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}Output schema0/100
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared