Crawlora Docs
Expose selected Crawlora endpoints as tool calls so agents can retrieve normalized JSON before summarizing or ranking results.
Expose selected Crawlora endpoints as tool calls so agents can retrieve normalized JSON before summarizing or ranking results.
Only endpoints that exist in the generated endpoint metadata are linked here. Missing optional endpoints are intentionally omitted.
/google/searchReturns normalized Google web search results. Results are fetched through Rayobrowse-rendered Chrome with availability fanout and stale-cache fallback when available. The endpoint returns 502 when Google serves a challenge page or unusable HTML. Rate limit is enforced at 1 request per second, and if the limit is exceeded a 429 status code is returned with rate limit headers.
/google/map/searchReturns results from Google Maps based on search options. Rate limit is enforced at 1 request per second.
/youtube/transcript/{id}Returns transcript segments for a YouTube video using YouTube's native player captions. Set `format=text`, `format=srt`, or `format=vtt` to receive plain-text output instead of the standard response envelope.
/tiktok/searchSearches TikTok videos by keyword with cursor-based pagination.
/appstore/searchReturns App Store search results for a term. Set `ids_only=true` to return only app IDs.
/googleplay/searchReturns Google Play search results for a term.
/amazon/product/{asin}Returns normalized product details for an Amazon ASIN on `amazon.com`, including pricing, availability, overview data, inline review samples, and descriptive content.
/producthunt/searchPerforms a full-text Product Hunt search and returns matching products, users, or launches.
| Field | Notes |
|---|---|
| task_id | Workflow field; map to exact endpoint response fields from endpoint docs. |
| tool_name | Workflow field; map to exact endpoint response fields from endpoint docs. |
| endpoint | Workflow field; map to exact endpoint response fields from endpoint docs. |
| input | Workflow field; map to exact endpoint response fields from endpoint docs. |
| result_summary | Workflow field; map to exact endpoint response fields from endpoint docs. |
| source_ids | Workflow field; map to exact endpoint response fields from endpoint docs. |
| request_id | Workflow field; map to exact endpoint response fields from endpoint docs. |
| credits_used | Include when response or usage data makes it available. |
| created_at | Workflow field; map to exact endpoint response fields from endpoint docs. |
This example uses the real Google search API endpoint. Exact request fields come from the endpoint metadata.
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X POST "https://api.crawlora.net/api/v1/google/search" \
-H "x-api-key: $CRAWLORA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country":"us","keyword":"chatgpt","language":"en","limit":10,"page":1}'Use endpoint detail pages for exact response schemas. This recipe does not invent response fields.
{
"code": 200,
"msg": "OK",
"data": {
"result": [
{
"position": 1,
"title": "ChatGPT",
"website_name": "ChatGPT",
"icon": "",
"link": "https://chatgpt.com/",
"Snippet": "ChatGPT helps you get answers and create."
}
]
}
}This is an illustrative agent tool schema, not an exact MCP schema. Use the MCP docs when a specific tool schema is available.
{
"name": "crawlora_google_search",
"description": "Search public Google results through Crawlora and return structured results.",
"parameters": {
"type": "object",
"properties": {
"query": { "type": "string" },
"country": { "type": "string" },
"language": { "type": "string" }
},
"required": ["query"]
}
}Store tool inputs, response summaries, and source identifiers so agent outputs can be audited.
Estimate usage by multiplying requests by endpoint credit cost. The table below only shows real credit costs available from the billing constants.
| Endpoint | Credit cost | Docs |
|---|---|---|
| Google search API | 3 credits/request | /docs/Google/google-search |
| Google Maps search API | 5 credits/request | /docs/Google%20Map/google-map-search |
| Retrieve transcript for a YouTube video | 3 credits/request | /docs/YouTube/youtube-transcript |
| Search TikTok videos | 8 credits/request | /docs/TikTok/tiktok-search |
| Search the App Store | 1 credit/request | /docs/AppStore/appstore-search |
| Search Google Play | 1 credit/request | /docs/GooglePlay/googleplay-search |
| Retrieve Amazon product details | 2 credits/request | /docs/Amazon/amazon-product |
| Search for products, users, or launches on Product Hunt | 3 credits/request | /docs/ProductHunt/producthunt-search |
Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora termsUse this recipe for workflow shape, then rely on endpoint reference pages for exact paths, request schemas, response schemas, and credit costs.