Skip to content
Agentic Scraper

Create automations

Automations are persistent schedules. They continue running until their stored configuration is changed or disabled through the product. If you only need one execution, use the one-off runs guide.

All requests use:

https://api.agenticscraper.com/api/v1

Every request requires X-API-Key. Requests with a JSON body also require Content-Type:

X-API-Key: <your account API key>
Content-Type: application/json

Supported automation types

Automation Create operation Required account configuration
Reddit agent POST /automations Saved Reddit account or inline Reddit credentials
X agent POST /automations Saved X account for authenticated actions
Custom agent POST /agents None unless the selected tools require parameters

POST /automations stores the recurring schedule and also queues the first execution immediately. The cron expression controls later executions.

Create a Reddit automation with a saved account

Create and validate the account first, then use its UUID:

Terminal window
curl --request POST \
  --url https://api.agenticscraper.com/api/v1/automations \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $AGENTIC_SCRAPER_API_KEY" \
  --data '{
    "name": "Daily subreddit research",
    "cron": "0 9 * * *",
    "timezone": "Europe/Istanbul",
    "task": "Find the highest-signal posts in r/LocalLLaMA and summarize the recurring topics.",
    "automation_type": "reddit-agent",
    "llm_provider": "agentic_scraper",
    "llm_model": "deepseek/deepseek-chat-v3-0324",
    "reddit": {
      "mode": "saved",
      "accountIds": ["<reddit-account-uuid>"]
    },
    "structured_output": [
      { "id": "summary", "type": "string" },
      { "id": "post_urls", "type": "string[]" }
    ]
  }'

Use "useAll": true instead of accountIds to make every saved Reddit account available to the run.

Create a Reddit automation with inline credentials

Inline credentials are validated before the automation is stored:

Terminal window
curl --request POST \
  --url https://api.agenticscraper.com/api/v1/automations \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $AGENTIC_SCRAPER_API_KEY" \
  --data '{
    "name": "Reddit trend monitor",
    "cron": "0 */6 * * *",
    "timezone": "UTC",
    "task": "Report newly emerging discussions about browser agents.",
    "automation_type": "reddit-agent",
    "reddit": {
      "mode": "inline",
      "credentials": {
        "redditClientId": "<reddit-client-id>",
        "redditClientSecret": "<reddit-client-secret>",
        "redditUserAgent": "my-product/1.0"
      }
    }
  }'

Prefer saved accounts when the same credentials are reused by more than one automation.

Create an X automation

X automations accept saved accounts only. Add the X account first and pass its UUID:

Terminal window
curl --request POST \
  --url https://api.agenticscraper.com/api/v1/automations \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $AGENTIC_SCRAPER_API_KEY" \
  --data '{
    "name": "Daily X competitor report",
    "cron": "30 8 * * *",
    "timezone": "Europe/Istanbul",
    "task": "Review the latest posts from the configured accounts and produce a competitor activity report.",
    "automation_type": "x-agent",
    "llm_provider": "agentic_scraper",
    "llm_model": "google/gemini-2.5-flash",
    "x": {
      "mode": "saved",
      "accountIds": ["<x-account-uuid>"]
    },
    "captcha_solver_enabled": true,
    "proxy_enabled": true,
    "proxy_country": "US",
    "structured_output": [
      { "id": "summary", "type": "string" },
      { "id": "notable_posts", "type": "string[]" }
    ]
  }'

The selected browser runtime, CAPTCHA solver, proxy, LLM, and tool usage can create billable usage.

Create a scheduled custom agent

Custom agents use POST /agents rather than POST /automations:

Terminal window
curl --request POST \
  --url https://api.agenticscraper.com/api/v1/agents \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $AGENTIC_SCRAPER_API_KEY" \
  --data '{
    "name": "Weekly documentation analyst",
    "cron": "0 10 * * 1",
    "task": "Review the selected documentation source and report important changes.",
    "system_prompt": "Use tools for factual claims and include source URLs.",
    "expected_output": "A concise changelog with links.",
    "llm_provider": "agentic_scraper",
    "llm_model": "google/gemini-2.5-flash",
    "max_tool_calls": 12,
    "structured_output": [
      { "id": "summary", "type": "string" },
      { "id": "sources", "type": "string[]" }
    ],
    "market_mcps": [
      {
        "mcp_id": "<approved-mcp-uuid>",
        "tool_names": ["search_documentation"],
        "params": {}
      }
    ]
  }'

Omit market_mcps, custom_mcps, skills, or structured output fields when they are not needed.

List automations

The list includes active and paused Reddit, X, and custom-agent cron records:

Terminal window
curl \
  --url "https://api.agenticscraper.com/api/v1/automations?page=1&pageSize=20" \
  --header "X-API-Key: $AGENTIC_SCRAPER_API_KEY"

The response contains automations and pagination meta. Secrets in stored payloads are masked.

The public REST API currently exposes creation and listing for Reddit/X automations, plus create/update for scheduled custom agents. It does not expose the dashboard’s internal pause, delete, or manual-run routes. Do not call internal service URLs from an integration.