📖 API DOCS

Getting Started

All Actor Arsenal actors run on the Apify platform. You'll need an Apify account and API token to use them programmatically.

Step 1: Get Your API Token

Go to Apify Console > Settings > Integrations to find your API token.

Step 2: Install the Apify Client

# Node.js
npm install apify-client

# Python
pip install apify-client

Step 3: Run Your First Actor

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

// Run the Citation God Mode actor
const run = await client.actor('alizarin_refrigerator-owner/citation-god-mode').call({
    businessName: 'Your Business Name',
    address: '123 Main St, City, ST 12345',
    phone: '555-123-4567',
});

// Get results
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Authentication

All API requests require authentication via your Apify API token.

Header Authentication

Authorization: Bearer YOUR_API_TOKEN

Query Parameter

https://api.apify.com/v2/acts/...?token=YOUR_API_TOKEN

Running Actors

Start Actor Run

// Start run and wait for completion
const response = await fetch(
    'https://api.apify.com/v2/acts/alizarin_refrigerator-owner/citation-god-mode/runs?waitForFinish=300',
    {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${API_TOKEN}`,
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            businessName: 'Acme Corp',
            address: '123 Main St, Austin, TX 78701',
            phone: '512-555-1234',
        }),
    }
);

Citation Checker API

Check NAP consistency across 60+ business directories.

Input Schema

Output Schema

{
    "summary": {
        "totalPlatforms": 60,
        "foundOn": 42,
        "consistentNAP": 38,
        "inconsistencies": 4,
        "napScore": 90.5
    },
    "citations": [
        {
            "platform": "Google Business Profile",
            "found": true,
            "nameMatch": true,
            "addressMatch": true,
            "phoneMatch": true,
            "listingUrl": "https://..."
        }
    ]
}

Social Posters API

Automate posting to social media platforms.

Common Input Fields

Facebook Poster Example

await client.actor('alizarin_refrigerator-owner/facebook-poster').call({
    pageId: 'your-page-id',
    text: 'Check out our latest updates!',
    imageUrl: 'https://example.com/image.jpg',
    sessionCookie: 'your-session-cookie',
});

LinkedIn Poster Example

await client.actor('alizarin_refrigerator-owner/linkedin-poster').call({
    postType: 'company', // or 'personal'
    companyId: 'your-company-id',
    text: 'Exciting news from our team!',
    sessionCookie: 'li_at=your-cookie',
});

Sports APIs

Real-time sports data from official league APIs.

NFL API Example

const run = await client.actor('alizarin_refrigerator-owner/nfl-api---football-statistics').call({
    action: 'standings', // standings, schedule, teams, scores
    season: 2024,
    week: 17, // optional for scores
});

// Returns team standings, records, division rankings

Available Actions (All Sports APIs)

MCP Servers

Model Context Protocol servers for AI assistants like Claude.

What is MCP?

MCP (Model Context Protocol) is a standard for connecting AI assistants to external tools and data sources. Our MCP servers let Claude and other AI assistants use Apify actors as tools.

Using with Claude Desktop

Add to your claude_desktop_config.json:

{
    "mcpServers": {
        "local-seo": {
            "command": "npx",
            "args": ["@anthropic/mcp-remote", "https://actors-mcp.apify.actor/alizarin_refrigerator-owner/local-seo-mcp-server"],
            "env": {
                "APIFY_TOKEN": "your-api-token"
            }
        }
    }
}

Available MCP Servers

Webhooks

Get notified when actor runs complete.

Setting Up Webhooks

const run = await client.actor('alizarin_refrigerator-owner/citation-god-mode').call(
    {
        businessName: 'Acme Corp',
        address: '123 Main St',
    },
    {
        webhooks: [
            {
                eventTypes: ['ACTOR.RUN.SUCCEEDED', 'ACTOR.RUN.FAILED'],
                requestUrl: 'https://your-server.com/webhook',
            }
        ]
    }
);

Webhook Payload

{
    "eventType": "ACTOR.RUN.SUCCEEDED",
    "eventData": {
        "actorId": "...",
        "actorRunId": "...",
        "defaultDatasetId": "...",
        "status": "SUCCEEDED"
    }
}