Scraping API

Map API

Map is a scraping api from firecrawl that teams use to extract structured data from public websites through one SkillBoss endpoint.

It returns structured output from model firecrawl/map, supports per request billing, and gives agents a stable invocation contract instead of vague routing hints.

Extract structured data from public websites

Automate repetitive research and monitoring

Feed fresh web data into AI agents and workflows

Direct Answer

What this API does

Map is a scraping api exposed through SkillBoss. Use it when you need to extract structured data from public websites, want one stable request surface, and need a model ID and billing path that both humans and agents can act on quickly.

Best Fit

You want Map behind one stable SkillBoss endpoint instead of wiring up firecrawl directly.

You need a canonical page with copyable request shape, pricing context, and model ID for developer handoff or agent routing.

You want deterministic per-call billing that can support machine payment flows.

Watchouts

If you need vendor-specific account features outside the SkillBoss gateway, you may still need native setup.

If you need a different capability category, use the catalog and vendor links below instead of forcing the wrong endpoint.

Capability Snapshot

Endpoint

POST /v1/run

Auth

Bearer API key

Model

firecrawl/map

Payments

Standard API key, x402, Payment Later

Canonical URL

https://www.skillboss.co/th/use/sitemap-api

How to invoke this API

Step 1

Send one POST request

Use https://api.skillboss.co/v1/run with a standard JSON body and your SkillBoss API key.

Step 2

Pin the exact model ID

Set "model": "firecrawl/map" so your app or agent routes to the intended capability consistently.

Step 3

Choose the right billing path

This API can support machine payments via x402 and Payment Later. Keep the standard API key flow as the default unless your agent specifically benefits from machine-native payment rails.

Request Shape

Copyable JSON for agents and developers

Per request
{
  "model": "firecrawl/map",
  "inputs": {
        "url": "https://example.com"
      }
}

Example Response

{
  "id": "run_123",
  "output": {
    "items": [
      {
        "title": "Example result",
        "url": "https://example.com"
      }
    ]
  }
}

For Humans

Where teams use this API

Ops and growth teams pulling structured records from websites

Analysts collecting fresh external data without manual copy-paste

Founders validating markets, leads, and competitors faster

For Agents

How this fits agent workflows

Agents that fetch fresh web data before answering or taking action

Monitoring bots that watch websites for changes or new records

Research agents that turn messy pages into structured inputs

Best Use Cases

Extract structured data from public websites

Automate repetitive research and monitoring

Feed fresh web data into AI agents and workflows

Quick Start

cURL

curl -X POST https://api.skillboss.co/v1/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "firecrawl/map",
    "inputs": {
          "url": "https://example.com"
        }
  }'

Python

import requests

response = requests.post(
    "https://api.skillboss.co/v1/run",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "firecrawl/map",
        "inputs": {
              "url": "https://example.com"
            }
    }
)

print(response.json())

Payment Options

x402 and Payment Later

This API can support machine payments via x402 and Payment Later. This endpoint has deterministic per-request pricing, which makes it a reasonable fit for pay-per-call machine payment flows such as x402 and Stripe-backed Payment Later.

x402

USDC on Base

Status: Supported. Use x402 when an agent can know the exact price before execution and pay onchain request by request.

Payment Later

Stripe-backed machine payments

Status: Supported. Use Payment Later when an agent should pay with card-backed machine payments instead of prefunded crypto.

x402 Code

from x402.client import X402Client

client = X402Client(
    wallet_address="0xYOUR_WALLET",
    private_key="0xYOUR_PRIVATE_KEY",
    network="base",
)

response = client.post(
    "https://api.skillboss.co/v1/run",
    json={
        "model": "firecrawl/map",
        "inputs": {
              "url": "https://example.com"
            }
    }
)

print(response.json())

Payment Later Code

import requests
import stripe

stripe.api_key = "sk_test_your_stripe_key"

spt = stripe.PaymentMethod.create_shared_token(
    payment_method="pm_your_payment_method",
    amount=100,
    currency="usd",
)

response = requests.post(
    "https://api.skillboss.co/v1/run",
    headers={
        "Authorization": f"Payment {spt.id}",
        "Content-Type": "application/json",
    },
    json={
        "model": "firecrawl/map",
        "inputs": {
              "url": "https://example.com"
            }
    }
)

print(response.json())

Why this page is easier to discover and route

Canonical

One stable cited URL

The canonical page, model ID, and request surface are visible above the fold, which reduces ambiguity for searchers and agents.

Extractable

Decision blocks before detail

Direct-answer, best-fit, watchout, and invocation sections expose the critical facts in short standalone passages.

Operational

Launch-ready payment guidance

Payment guidance is separated from quick start, so users can launch first and choose x402 or Payment Later only when it actually fits.

Frequently Asked Questions

What is the Map API used for?

Map is a scraping api available through SkillBoss. Teams use it for extract structured data from public websites without managing separate vendor credentials.

What inputs does Map require?

Send a POST request to https://api.skillboss.co/v1/run with "model": "firecrawl/map" and an "inputs" object containing the capability-specific parameters shown in the request example on this page.

What does a successful response look like?

Successful responses return a run identifier plus a structured output payload. The exact shape varies by capability, and this page shows a representative example response block so developers and agents can plan parsing correctly.

Is pricing per request or per token?

Map uses per request pricing on SkillBoss. Check the pricing card and payment section on this page before wiring billing logic into your app or agent.

When should I use x402 or Payment Later instead of a standard API key?

This API can support machine payments via x402 and Payment Later. This endpoint has deterministic per-request pricing, which makes it a reasonable fit for pay-per-call machine payment flows such as x402 and Stripe-backed Payment Later.

What is the native vendor behind this API?

The underlying vendor for this endpoint is firecrawl. SkillBoss provides the unified API surface, billing layer, and canonical discovery page for Map.

Ready to use Map?

Get your API key, call firecrawl/map, and use this capability in both product workflows and AI agents.