{"uid":"cap_dm2x3-khK4WZX8lsKfBRs","slug":"botsmith-google-serp-search-c5da9a60","name":"botsmith Google SERP Search","description":"Google SERP Search ($0.005/call): Google search results as clean JSON (title, URL, domain, snippet, rank) - one page per call. No API key needed.","url":"https://x402.botsmith.dev/serp/search","method":"GET","headers":{},"bodySchema":{"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","location_code","num"],"properties":{"num":{"type":"integer","default":10,"maximum":20,"minimum":1,"description":"How many organic results (max 20)"},"query":{"type":"string","maxLength":400,"minLength":1,"description":"Search query, plain Google syntax"},"location_code":{"type":"integer","default":2840,"maximum":9007199254740991,"minimum":-9007199254740991,"description":"DataForSEO location code (default 2840 = United States)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","resultsCount","results"],"properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","required":["position","title","url","domain","snippet"],"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}]},"position":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false},"description":"Organic results in rank order"},"resultsCount":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}],"description":"Total results Google reports for the query"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qhrLiHrYSM6eJwPm0WCJH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Google search results as clean JSON (title, URL, domain, snippet, rank) for a given query, with optional location targeting and result count control.","exampleAgentPrompt":"Search Google for 'best electric cars 2025' and give me the top 10 results including their titles, URLs, and snippets — US location.","exampleUseCases":[{"title":"Competitive research on search rankings","prompt":"Search Google for 'project management software' and show me the top 10 organic results — titles, URLs, and snippets — so I can see who's ranking for that term."},{"title":"Real-time news lookup on a topic","prompt":"Do a Google search for 'OpenAI GPT-5 release date' and return the top 5 results so I can find the latest news on this."},{"title":"Location-targeted local search","prompt":"Search Google for 'best pizza restaurants' using location code 1023191 for New York City and bring back the top 10 results with titles, domains, and snippets."}],"resultDescription":"A JSON object containing the original query string, total results count Google reports, and an array of up to 20 organic results each with position (rank), title, URL, domain, and snippet. Results are ordered by rank ascending.","failureModes":["Empty results array if the query returns no organic results","Null values for title, URL, domain, or snippet on individual results if Google omits them","Invalid or unsupported location_code returns results defaulting to US or an error","Query exceeding 400 characters rejected at input validation","num parameter outside 1-20 range rejected","Payment failure if USDC balance is insufficient for the $0.005 call fee"],"whenToPreferThis":"Choose this endpoint when you need clean, structured Google SERP data without managing a Google API key or quota, especially when you need per-call pay-as-you-go pricing at $0.005. Prefer it over raw web scrapers when you want normalized JSON output (title, URL, domain, snippet, rank) with location targeting. Best suited for agents doing research, competitive analysis, or real-time information lookup via Google's index.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:08.676Z","isFirstParty":false}