Technical Reference

API Access

Protocol Documentation & API Management

Quick Start

Secure your requests by including an Authorization bearer token in every header.

Base endpoint

https://api.xiaoflow.com/api

Authorization Layer

Authorization: Bearer YOUR_TOKEN

MCP Protocol

Native SEO Injections

The Model Context Protocol (MCP) enables LLMs like Claude to use XiaoFlow tools directly. Connect your intelligence layer to our search data.

Setup Guide

Protocol Index

GET/api/keywords

1 Compute Unit / Request

Algorithmic keyword discovery & market intelligence analysis. Supports multi-vector seeds: keywords, domains, or specific URLs.

apiDocs.property	apiDocs.primitive	apiDocs.description
keyword	string	Primary search vector (e.g. "wedding rings").
url	string	Target individual page URL for landing page extraction.
site	string	Root domain or subdomain for full-site keyword mapping.
location_id	string	Geo-node ID or ISO code (e.g., 2840 or US).
language_id	string	Language vector ID or code (e.g., 1000 or en).
page_size	integer	Total results to return.

Implementation Example

curl -G "https://api.xiaoflow.com/api/keywords" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d keyword=wedding%20rings \
  -d location_id=US \
  -d language_id=en

POST/api/keywords/bulk

1 Compute Unit / Request

High-throughput bulk metrics retrieval for up to 1,000 keywords.

apiDocs.property	apiDocs.primitive	apiDocs.description
keywords •	array	Array of keyword strings.
location_id	string	Geo-node ID or ISO code (e.g., 2840 or US).
language_id	string	Language vector ID or code (e.g., 1000 or en).

Implementation Example

curl -X POST "https://api.xiaoflow.com/api/keywords/bulk" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["wedding rings", "diamond rings"], "location_id": "US", "language_id": "en"}'

GET/api/keywords/{slug}

1 Compute Unit / Request

48-month granular trend matrix and metrics for a specific keyword vector.

apiDocs.property	apiDocs.primitive	apiDocs.description
slug •	string	URL-safe keyword identifier.
location_id	string	Geo-node ID or ISO code (e.g., 2840 or US).
language_id	string	Language vector ID or code (e.g., 1000 or en).
time_range	string	Temporal window (12m, 24m, 48m).

Implementation Example

curl "https://api.xiaoflow.com/api/keywords/wedding-rings?time_range=48m&location_id=US&language_id=en" \
  -H "Authorization: Bearer YOUR_TOKEN"

Protocol Matrix

Daily Guest Quota5 Requests

Daily Tier-1 Quota10 Requests

Unit Multiplier1.0x Core

Format Strict JSON

Auth Bearer JWT

Standard Provisioning

Authorized entities can generate unique credentials for high-throughput pipeline integration.

Generate Access Key