Use the PromptLoop API

Run PromptLoop tasks programmatically to automate data enrichment, web scraping, and AI research directly from your applications.

Prerequisites

A PromptLoop account (contact support@promptloop.com for API access)
At least one task created in PromptLoop
An API key from your settings page

Pro tip

Build and test your task in the PromptLoop interface first. The API runs existing tasks—it doesn't create them.

Steps

1. Get your API key

Log in to PromptLoop
Go to Settings → API Keys
Click Create API Key
Copy and save the key securely (you won't see it again)

2. Find your task ID

Open the task you want to run via API
Copy the task ID from the URL or task settings
Note which inputs the task requires (e.g., website URL, company name)

3. Run a single job

Send a POST request with your input data:

curl --request POST \
  --url https://api.promptloop.com/v0.1/tasks/YOUR_TASK_ID \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "task_version": 0,
  "inputs": [
    "promptloop.com"
  ]
}'

Response:

{
  "status": "success",
  "data": {
    "job_id": "6497b030-f841-4421-ab39-7e0c16e83ee6",
    "error_detected": false,
    "data_json": {
      "Site Description": "PromptLoop is an AI platform for GTM and B2B sales...",
      "Contact Email": "[email protected]"
    }
  }
}

4. Use batch processing for multiple rows

For larger datasets, use the batch API to send multiple inputs at once and receive results via webhook when complete.

What you can do with the API

Enrich company datasets with AI web research
Build proprietary GTM datasets for sales and marketing
Automate AI transformations on spreadsheet text data
Scrape and extract structured data from websites
Integrate with your tools like CRMs, data warehouses, or custom apps

Quality checks

API key is stored securely (not in version control)
Task works correctly in PromptLoop UI before using API
Error handling is in place for failed requests
Webhook endpoint is ready for batch processing

FAQs

Do I need an enterprise plan for API access?
Yes. API access is available on enterprise plans. Contact support@promptloop.com to enable it.

Can I create tasks via the API?
Not yet. Tasks must be created in the PromptLoop interface, then you can run them via API.

How do I handle rate limits?
Use the batch API for large jobs—it automatically manages rate limits and processing queues.

Can I get webhooks when jobs complete?
Yes. Batch jobs support webhooks. Contact support to configure your webhook endpoint.