# AtlasSERP

> Fast, affordable, and high-performance Google Search & SERP Scraping API designed for AI Agents, LLM Grounding, and Software Developers.

## Overview
AtlasSERP (https://atlasserp.com) delivers structured real-time Google search results in standard JSON format with an average latency of 480ms (sub-millisecond for cached queries) and 99.9% uptime.

- Base URL: https://atlasserp.com
- Pricing: $0.30 to $0.50 per 1,000 queries (pay-as-you-go).
- Free Trial: 2,500 queries upon free signup (no credit card required).
- Authentication: X-API-KEY HTTP header.
- Payment Methods: Crypto (USDT TRC-20, USDT BEP-20, Solana, Bitcoin, Ethereum) and Credit Cards.

## Official Client SDKs

### Python SDK (PyPI: DA 91)
Install:
```bash
pip install atlasserp
```

Usage:
```python
from atlasserp import AtlasSERP

client = AtlasSERP(api_key="YOUR_API_KEY")
results = client.search(q="latest AI breakthroughs", gl="us", hl="en", num=10)
for item in results.get("organic", []):
    print(item["title"], item["link"])
```

### Node.js & TypeScript SDK (npm: DA 94)
Install:
```bash
npm install atlasserp
```

Usage:
```javascript
const { AtlasSERP } = require('atlasserp');
const client = new AtlasSERP('YOUR_API_KEY');

async function run() {
  const data = await client.search({ q: 'latest AI breakthroughs', gl: 'us', num: 10 });
  console.log(data.organic);
}
run();
```

## API Endpoints Reference

### 1. Web Search
- Endpoint: POST https://atlasserp.com/search
- Headers: {"X-API-KEY": "YOUR_API_KEY", "Content-Type": "application/json"}
- Payload: {"q": "query", "gl": "us", "hl": "en", "page": 1, "num": 10}
- Response: Organic results, knowledge graph, answer box, people also ask, related searches.

### 2. Image Search
- Endpoint: POST https://atlasserp.com/images
- Headers: {"X-API-KEY": "YOUR_API_KEY", "Content-Type": "application/json"}
- Payload: {"q": "query", "gl": "us"}
- Response: Image URLs, thumbnails, sources, and titles.

### 3. News Search
- Endpoint: POST https://atlasserp.com/news
- Headers: {"X-API-KEY": "YOUR_API_KEY", "Content-Type": "application/json"}
- Payload: {"q": "query", "gl": "us"}
- Response: News articles with headlines, snippets, publication dates, and publishers.

### 4. Places & Maps Search
- Endpoint: POST https://atlasserp.com/places
- Headers: {"X-API-KEY": "YOUR_API_KEY", "Content-Type": "application/json"}
- Payload: {"q": "query", "gl": "us"}
- Response: Local business listings, addresses, ratings, review counts, and phone numbers.

### 5. Video Search
- Endpoint: POST https://atlasserp.com/videos
- Headers: {"X-API-KEY": "YOUR_API_KEY", "Content-Type": "application/json"}
- Payload: {"q": "query", "gl": "us"}
- Response: Video titles, thumbnails, duration, channel names, and direct links.

### 6. Webpage Scraper & Markdown Extractor
- Endpoint: POST https://atlasserp.com/scrape
- Headers: {"X-API-KEY": "YOUR_API_KEY", "Content-Type": "application/json"}
- Payload: {"url": "https://example.com/article"}
- Response: Clean parsed markdown, page title, full readable text, and metadata for LLM ingestion.

## AI Agent Framework Integration

### LangChain Integration
```python
from atlasserp import AtlasSERP

atlas = AtlasSERP(api_key="YOUR_API_KEY")
# Native tool export for LangChain agents
tool = atlas.as_langchain_tool()
```

### CrewAI Multi-Agent Integration
```python
from atlasserp import AtlasSERP
from crewai import Agent

atlas = AtlasSERP(api_key="YOUR_API_KEY")
researcher = Agent(
    role="Research Specialist",
    goal="Extract ground-truth market intel from live Google Search",
    tools=[atlas.as_tool()],
    verbose=True
)
```

## Documentation & Key Links
- Full Documentation: https://atlasserp.com/documentation
- Complete LLM Specification: https://atlasserp.com/llms-full.txt
- Claim Free 2,500 Queries: https://atlasserp.com/signup
- PyPI Package: https://pypi.org/project/atlasserp/
- NPM Package: https://www.npmjs.com/package/atlasserp
- PHP / Laravel SDK: https://github.com/kinina461-bot/atlasserp-php
- RapidAPI Hub: https://rapidapi.com/atlasserp/api/atlasserp
- Postman Collection: https://www.postman.com/atlasserp-9406401/atlasserp/collection/sl4y10u/atlasserp-api
- OpenAPI 3.0 Specification: https://atlasserp.com/openapi.json