find-leads

List the columns a search would create

The columns a table built from this search type can show, in order, and which of them a preview reveals. Free to call and never fetches a row, so a builder can draw the table header before any preview is bought. A column that no added lead fills is left out when the table is created; a preview, which has leads in hand, lists only the columns they fill. Buying-signal searches take the chosen signal as signal_type, which adds the columns that signal's own details earn. Also answers what one row of this search type costs and whether it can be previewed at all, so the price and the preview button are decided by the same free call that draws the header.

get/find-leads/columns/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/find-leads/columns/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

record_type'people' | 'companies' | 'signal_companies' | 'signal_people' | 'lookalikes' | 'local_businesses' | 'hiring_companies' | 'backlinks' | 'search_results' | 'post_authors' required

Which dataset a search runs against, and so which provider serves it.

Values are persisted in String(16) columns, so every member must stay within 16 characters.

signal_typestring nullable

For a buying-signal search, the one signal it looks for. Ignored for every other search.

Response

Successful Response

credits_per_requestnumber
credits_per_rownumber required

What one row of this search type costs, in credits, before any enrichment is chosen. Zero for the search types whose rows are free. Charged on the rows a run adds, so a run that adds nothing costs nothing. Quoted here because this is the one free call a builder makes before anything is spent: asking the price must never itself cost a row.

preview_supportedboolean required

Whether this search type can be sampled before it is added. The backend lists which datasets offer an explicit sample. This is independent of row pricing; automatic counts are only available when the data source counts for free.

rows_per_requestinteger

Changes

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