# Machine Market Social – Fetch Public Social Post

> Machine Market Social – Fetch Public Social Post is a paid API for AI agents from machine-market-social-mainnet.machine-market.workers.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-13).

Fetches structured metadata for a single public social media post from TikTok or Instagram.

## Facts

- Endpoint: GET https://machine-market-social-mainnet.machine-market.workers.dev/post?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/machine-market-social-fetch-public-social-post-9709c09b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4nzKcdEJskNQE_xWz4d3w

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability machine-market-social-fetch-public-social-post-9709c09b
```

Example prompt: Can you pull the structured data for this TikTok post — https://www.tiktok.com/@creator/video/123456789 — using live freshness so I get the latest stats?

## When to prefer this

Use this endpoint when you need structured, machine-readable data for a single known social post on TikTok or Instagram — especially when you have the direct post URL and want to avoid writing your own scraper. It supports freshness control (live, 24h, 7d) so you can trade off latency and cost. Prefer it over general web scrapers when you need normalized, schema-consistent output with post-level metadata.

## Known failure modes

- Invalid or private post URL returns an error — post must be public
- Unsupported platform (anything other than tiktok or instagram) will be rejected
- Post has been deleted or made private since last crawl — stale or missing data
- Rate limits or upstream platform blocks may cause fetch failures
- Malformed URL in the target parameter causes a validation error

## How this service works

Fetch structured data for one public social post.

## Output

Returns a structured JSON object with success status, platform name, provider (machine.market), post type, freshness info (whether cached and the observed_at ISO 8601 timestamp), and a data object containing post-specific fields such as caption, like count, view count, share count, and other platform-native metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "platform",
      "target"
     ],
     "properties": {
      "target": {
       "type": "string",
       "minLength": 1,
       "description": "Public TikTok video URL"
      },
      "platform": {
       "enum": [
        "tiktok",
        "instagram"
       ],
       "type": "string",
       "description": "Social or creator-link platform adapter."
      },
      "freshness": {
       "enum": [
        "live",
        "24h",
        "7d"
       ],
       "type": "string",
       "default": "live",
       "description": "Maximum acceptable upstream freshness policy."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "provider",
      "platform",
      "type",
      "freshness",
      "data"
     ],
     "properties": {
      "data": {
       "type": "object",
       "additionalProperties": true
      },
      "type": {
       "type": "string",
       "const": "post"
      },
      "success": {
       "type": "boolean",
       "const": true
      },
      "platform": {
       "type": "string"
      },
      "provider": {
       "type": "string",
       "const": "machine.market"
      },
      "freshness": {
       "type": "object",
       "required": [
        "cached",
        "observed_at"
       ],
       "properties": {
        "cached": {
         "type": "boolean"
        },
        "observed_at": {
         "type": "string",
         "description": "ISO 8601 timestamp"
        }
       }
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/machine-market-social-fetch-public-social-post-9709c09b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from machine-market-social-mainnet.machine-market.workers.dev](https://www.zero.xyz/host/machine-market-social-mainnet.machine-market.workers.dev/llms.txt)