Request research

File a research request: Ploti answers the user's question end to end when it needs data Ploti does not have. Ploti first checks which data the question needs (minutes), searching the web for sources, and reports what it already has and what is missing; when the check reports, Ploti files the missing pieces as data requests itself, which uses the workspace's research credits as the data is delivered. Its agents get the data, and when it arrives Ploti runs the research and emails the user the answer. Use it whenever the user needs data Ploti does not have, whether or not you know where it is published. Write the brief as the user would to an analyst: the question, the place, and what a good answer looks like; never the user's private parcels, owners or addresses unless the user asks for them to be researched. Creating the request and its data check costs nothing. Follow it with get_research_request.

post/v1/research-requests

Request

  • Base URL: https://api.ploti.ai
  • URL: https://api.ploti.ai/v1/research-requests
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique value, such as a UUID. A retry with the same key within a day returns the first answer instead of creating again; the same key with a different body is refused as idempotency_conflict.

Request body

titlestring required

The name the user sees for the question in Ploti's list of research requests, e.g. 'Vacant industrial land near the Tampa port'.

briefstring required

The question, the place it is about, and what a good answer looks like.

Response

Created

checkStartedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.