Skip to Content
APIQuickstart

IntentLoom API

The IntentLoom API lets scripts read your projects, manage their keyword and competitor configuration, and read Reddit post and comment leads — authenticated with a personal API token instead of a browser session.

All requests go to https://api.intentloom.com with the header:

Authorization: Token <key>

Use the Token scheme exactly — Bearer is never accepted for a personal API token. URLs keep their trailing slash exactly as documented.

Quickstart

  1. Create a token. Sign in to the IntentLoom dashboard , open API Tokens in the sidebar, and create a token (creation requires an active paid plan). Copy the secret from the confirmation dialog — it is shown exactly once.

  2. Find your project ID.

    export INTENTLOOM_API_TOKEN='il_live_REPLACE_WITH_YOUR_TOKEN' curl -fsS 'https://api.intentloom.com/api/v1/projects/' \ -H "Authorization: Token $INTENTLOOM_API_TOKEN"

    Pick a project and export its id from results — every project-scoped request uses it as the path parameter:

    export INTENTLOOM_PROJECT='b1a2c3d4-0000-4a5b-8c6d-7e8f9a0b1c2d'
  3. Read leads.

    curl -fsS "https://api.intentloom.com/api/v1/projects/$INTENTLOOM_PROJECT/leads/" \ -H "Authorization: Token $INTENTLOOM_API_TOKEN"

    A new or quiet project may return no leads yet. The default workflow=new covers only a recent 24-hour untouched window — add workflow=all to page through everything, including leads you already acted on:

    curl -fsS "https://api.intentloom.com/api/v1/projects/$INTENTLOOM_PROJECT/leads/?workflow=all&page_size=25" \ -H "Authorization: Token $INTENTLOOM_API_TOKEN"

Where to go next

The resource pages and the JSON download render the same committed Token-only projection of the Worker’s OpenAPI contract.

Last updated on