talordata-serp

TalorData SERP API

Search Google, Bing, Yandex, or DuckDuckGo using the TalorData SERP API. Returns structured JSON results including organic listings, news, images, and knowledge graph data.

📄 Docs: https://docs.talordata.com/serp-api/ 🔑 Sign up: https://talordata.com/?campaignid=mZledoF3kzfBtkWQ&utm_source=awesomeskills&utm_term=awesomeskills 💰 Pricing: $0.25/1K responses (free tier available)

When to use

• User asks to search the web for information
• User needs SERP data (Google, Bing, Yandex, DuckDuckGo)
• User wants to look up rankings, competitors, or market data
• User needs search results for AI agent context

When NOT to use

• User needs real-time content extraction from a specific URL (use a web scraper instead)
• User asks about TalorData account management or billing (not covered here)

Setup

1. Get a free API key from https://talordata.com/
2. Set it as an environment variable or pass it inline

API Reference

Endpoint: POST https://api.talordata.com/serp

Headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request body:

{
  "q": "search query",
  "source": "google",
  "num": 10,
  "news": false,
  "country": "us",
  "language": "en"
}

Parameters:

Parameter	Type	Default	Description
q	string	required	Search query
source	string	google	Engine: google, bing, yandex, duckduckgo
num	number	10	Number of results (1-100)
news	boolean	false	Set to true for news results
country	string	us	Country code for localized results
language	string	en	Language code (e.g. en, zh, ja)

Response structure:

{
  "organic": [
    {
      "title": "Page Title",
      "link": "https://example.com",
      "snippet": "Description text..."
    }
  ],
  "news": [],
  "knowledge_graph": {},
  "related_questions": []
}

Usage Examples

Basic web search (curl)

curl -s -X POST https://api.talordata.com/serp \
  -H "Authorization: Bearer $TALORDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "latest AI news 2026", "source": "google", "num": 5}' | jq '.organic[] | {title, link, snippet}'

Search with Python

import requests

API_KEY = "your-key"
response = requests.post(
    "https://api.talordata.com/serp",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "q": "best SERP API providers",
        "source": "google",
        "num": 10
    }
)

results = response.json()
for item in results.get("organic", []):
    print(f"{item['title']} - {item['link']}")

Multi-engine comparison

for engine in google bing duckduckgo; do
  curl -s -X POST https://api.talordata.com/serp \
    -H "Authorization: Bearer $TALORDATA_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"q\": \"climate change\", \"source\": \"$engine\", \"num\": 3}" \
    | jq --arg e "$engine" '{engine: $e, results: [.organic[]?.title]}'
done

News search

curl -s -X POST https://api.talordata.com/serp \
  -H "Authorization: Bearer $TALORDATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "technology", "source": "google", "num": 5, "news": true}' \
  | jq '.news[]? | {title, link, snippet}'

Notes

• Free tier includes a limited number of requests to get started
• Rate limits apply; check your dashboard for current limits
• Response format is consistent across all search engines
• For production use, set TALORDATA_API_KEY as an environment variable

---

## README.md 内容

```markdown
# TalorData SERP Skill

A Claude Code / Codex / Cursor skill for searching Google, Bing, Yandex, and DuckDuckGo via the TalorData SERP API.

## Usage

Install the skill and use it in your AI agent:

/load talordata-serp

Then ask: "Search Google for latest AI tools" or "Compare search results from Google and Bing for my query"

## Links

- [TalorData Website](	
https://talordata.com/?campaignid=mZledoF3kzfBtkWQ&utm_source=awesomeskills&utm_term=awesomeskills)
- [API Documentation](https://docs.talordata.com/serp-api/)
- [Sign Up (Free Tier)](	
https://talordata.com/?campaignid=mZledoF3kzfBtkWQ&utm_source=awesomeskills&utm_term=awesomeskills)