# SocialFetch Web Search

> SocialFetch Web Search is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-14).

Search the public web and return ranked organic results with snippets for a given query.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/web/search
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-web-search-936afecd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V9sPKnhpmVI0jH7aROBvi

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 socialfetch-web-search-936afecd
```

Example prompt: Search the web for 'best open-source LLM frameworks 2024' and show me the top ranked organic results — filter to the last month and use US results.

## When to prefer this

Use this endpoint when you need ranked organic web search results with snippets from the public internet, especially when you need recency filtering (last hour to last year), regional localization by country, or pagination across multiple result pages. Prefer this over social-media-specific endpoints when the query is general web content rather than platform-specific data.

## Known failure modes

- Empty or too-short query returns validation error (minLength:1 violated)
- Query exceeding 500 characters returns validation error (maxLength:500 violated)
- Invalid region code returns no localized results or an error
- Invalid datePosted enum value returns a schema validation error
- No results found for highly niche queries returns an empty result set
- Rate limit or payment failure returns 402 or 429 error

## How this service works

Search the public web and return ranked organic results with snippets.

## Output

A ranked list of organic web search results including page titles, URLs, and text snippets, paginated and optionally filtered by region and recency.

## 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": [
      "query"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": 1,
       "description": "Page number (1-based). Default: 1."
      },
      "query": {
       "type": "string",
       "maxLength": 500,
       "minLength": 1,
       "description": "Search query text to run against the public web."
      },
      "region": {
       "type": "string",
       "description": "ISO 3166-1 country code for localized results (e.g. US, GB, CA)."
      },
      "datePosted": {
       "enum": [
        "last-hour",
        "last-day",
        "last-week",
        "last-month",
        "last-year"
       ],
       "type": "string",
       "description": "Optional filter by when results were posted."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/socialfetch-web-search-936afecd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.socialfetch.dev](https://www.zero.xyz/host/api.socialfetch.dev/llms.txt)