IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
    • listSavedSearchesGET
    • getSavedSearchNetNewGET
    • runFolioPOST
    • getResearchGET
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
More endpoints

More endpoints

Other endpoints of the API.

listSavedSearches

Saved searches (Companies views) the key's creator can see: their own and the fund's shared ones. Each has its filters and alert state.

GEThttps://www.ideapulley.com/api/v2/saved-searchesdeals:read

Query parameters

NameType
limit

Items per page (1-200). Default 50.

integer
cursor

The next_cursor from the previous page. Up to 200 characters.

string
updated_since

Unix seconds. Only items created or changed at or after this time.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/saved-searches \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/saved-searches", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/saved-searches",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    { … }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

getSavedSearchNetNew

Net-new results: companies added after `since` that pass the saved search's filters, newest first (up to 200). With no `since`, the alert's last check is used, else the last 7 days. Read only: it does not move the alert clock. The `saved_search.net_new` webhook sends the same list when the alert runs.

GEThttps://www.ideapulley.com/api/v2/saved-searches/{id}/net-newdeals:read

Path parameters

NameType
idRequired

The ID.

integer

Query parameters

NameType
since

Unix seconds. Companies added after this time.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/saved-searches/42/net-new \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/saved-searches/42/net-new", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/saved-searches/42/net-new",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": { … }
}

runFolio

Run Folio on an application (and optional deck text): adds the deal, judges it (Claude reads the pitch, Arlo scores the founders, code decides; saved and sealed on the deal) and starts the public research. Spends credits. Poll GET /research/{researchId} for the report.

POSThttps://www.ideapulley.com/api/v2/foliodiligence:run

Headers

NameType
Idempotency-Key

Optional. A retry with the same key and body gets the first answer for 24 hours.

string

Body parameters

NameType
applicationRequired

Up to 40,000 characters.

string
deckText

Up to 30,000 characters.

string

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/folio \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"application":"…","deckText":"…"}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/folio", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "application": "…",
    "deckText": "…"
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/folio",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "application": "…",
        "deckText": "…"
    },
)
data = res.json()

Response

201 · application/json
{
  "data": { … }
}

getResearch

A research run: status, quick take, labelled brief, sources and cost.

GEThttps://www.ideapulley.com/api/v2/research/{id}deals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/research/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/research/42", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/research/42",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": { … }
}
IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
    • listSavedSearchesGET
    • getSavedSearchNetNewGET
    • runFolioPOST
    • getResearchGET
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
More endpoints

More endpoints

Other endpoints of the API.

listSavedSearches

Saved searches (Companies views) the key's creator can see: their own and the fund's shared ones. Each has its filters and alert state.

GEThttps://www.ideapulley.com/api/v2/saved-searchesdeals:read

Query parameters

NameType
limit

Items per page (1-200). Default 50.

integer
cursor

The next_cursor from the previous page. Up to 200 characters.

string
updated_since

Unix seconds. Only items created or changed at or after this time.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/saved-searches \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/saved-searches", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/saved-searches",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": [
    { … }
  ],
  "next_cursor": "eyJpZCI6NDJ9",
  "has_more": true
}

getSavedSearchNetNew

Net-new results: companies added after `since` that pass the saved search's filters, newest first (up to 200). With no `since`, the alert's last check is used, else the last 7 days. Read only: it does not move the alert clock. The `saved_search.net_new` webhook sends the same list when the alert runs.

GEThttps://www.ideapulley.com/api/v2/saved-searches/{id}/net-newdeals:read

Path parameters

NameType
idRequired

The ID.

integer

Query parameters

NameType
since

Unix seconds. Companies added after this time.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/saved-searches/42/net-new \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/saved-searches/42/net-new", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/saved-searches/42/net-new",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": { … }
}

runFolio

Run Folio on an application (and optional deck text): adds the deal, judges it (Claude reads the pitch, Arlo scores the founders, code decides; saved and sealed on the deal) and starts the public research. Spends credits. Poll GET /research/{researchId} for the report.

POSThttps://www.ideapulley.com/api/v2/foliodiligence:run

Headers

NameType
Idempotency-Key

Optional. A retry with the same key and body gets the first answer for 24 hours.

string

Body parameters

NameType
applicationRequired

Up to 40,000 characters.

string
deckText

Up to 30,000 characters.

string

Example request

cURL
curl -X POST https://www.ideapulley.com/api/v2/folio \
  -H "Authorization: Bearer $IDEAPULLEY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"application":"…","deckText":"…"}'
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/folio", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "application": "…",
    "deckText": "…"
  }),
});
const data = await res.json();
Python
import os
import requests

res = requests.post(
    "https://www.ideapulley.com/api/v2/folio",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
    json={
        "application": "…",
        "deckText": "…"
    },
)
data = res.json()

Response

201 · application/json
{
  "data": { … }
}

getResearch

A research run: status, quick take, labelled brief, sources and cost.

GEThttps://www.ideapulley.com/api/v2/research/{id}deals:read

Path parameters

NameType
idRequired

The ID.

integer

Example request

cURL
curl https://www.ideapulley.com/api/v2/research/42 \
  -H "Authorization: Bearer $IDEAPULLEY_KEY"
TypeScript
const res = await fetch("https://www.ideapulley.com/api/v2/research/42", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.IDEAPULLEY_KEY}`,
  },
});
const data = await res.json();
Python
import os
import requests

res = requests.get(
    "https://www.ideapulley.com/api/v2/research/42",
    headers={"Authorization": f"Bearer {os.environ['IDEAPULLEY_KEY']}"},
)
data = res.json()

Response

200 · application/json
{
  "data": { … }
}