Research a person
research_personStart source-reviewed research on a person using a person ID or LinkedIn profile URL, with optional goal, website, and anchor links; receive a resumable run ID for status tracking.
Instructions
Start source-reviewed research on one person, identified by exactly one of person_id (selected from search_people) or linkedin_url (an explicit HTTPS LinkedIn person profile URL); never pass both. For a name, search and ask the user to choose first. Set type to standard for lighter research (10 ACU) or leave the default deep (25 ACU); moving a standard profile up to deep costs the 15 ACU difference. Optionally pass goal (what to look for), website_url (their own site) and up to 10 anchors (public URLs you know belong to them, such as an X profile or a podcast episode); a run with these is not served from or saved to the shared profile. First workspace access is charged even for an already-cached profile; rereads at the same or a lower level within 90 days are free. Not-found and uncertain results are free. Returns a resumable run_id when pending; use get_research_status for the result.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | What to look for, up to 2000 characters. | |
| type | No | standard (10 ACU) or deep (25 ACU, the default). | |
| anchors | No | 1 to 10 public HTTPS URLs you know belong to this person, such as an X profile or a podcast episode. | |
| person_id | No | A person_id returned by search_people, up to 500 characters. Provide this or linkedin_url, not both. | |
| website_url | No | The person's own website, an HTTPS URL up to 2000 characters. | |
| linkedin_url | No | An HTTPS LinkedIn person profile URL such as https://www.linkedin.com/in/name, up to 2048 characters. Provide this or person_id, not both. |