{"info":{"name":"BestSERP","description":"Google search results as clean JSON: web, images, news, videos, shopping, places and maps.\n\nAuthenticate with your API key in the `X-API-KEY` header (or `Authorization: Bearer <key>`).\nEach request costs 1 credit per page of results; failed and busy requests are refunded.\nRequests not finished within `timeout` answer `202` with a `requestId`: poll `GET /requests/{requestId}`.\nErrors look like `{\"error\": {\"code\": \"...\", \"message\": \"...\"}, \"requestId\": \"...\"}`.\n","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"apikey","apikey":[{"key":"key","value":"X-API-KEY","type":"string"},{"key":"value","value":"{{apiKey}}","type":"string"},{"key":"in","value":"header","type":"string"}]},"variable":[{"key":"baseUrl","value":"http://api.bestserp.com"},{"key":"apiKey","value":"YOUR_API_KEY"},{"key":"requestId","value":""}],"item":[{"name":"Search","item":[{"name":"Web search","request":{"method":"POST","description":"Organic Google results, plus the page's video carousel (`videos`) and Top stories (`news`) when present.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/search","host":["{{baseUrl}}"],"path":["search"]},"body":{"mode":"raw","raw":"{\n  \"q\": \"best running shoes\",\n  \"gl\": \"us\",\n  \"hl\": \"en\",\n  \"num\": 10\n}","options":{"raw":{"language":"json"}}}}},{"name":"Web search (GET)","request":{"method":"GET","description":"Organic Google results, plus the page's video carousel (`videos`) and Top stories (`news`) when present. Same as the POST endpoint, with the parameters in the query string.","header":[],"url":{"raw":"{{baseUrl}}/search?q=coffee","host":["{{baseUrl}}"],"path":["search"],"query":[{"key":"q","value":"coffee","disabled":false,"description":"Search query"},{"key":"gl","value":"us","disabled":true,"description":"Country (2-letter code)"},{"key":"hl","value":"en","disabled":true,"description":"Interface language"},{"key":"num","value":"10","disabled":true,"description":"Results per page; each 10 costs 1 credit"},{"key":"page","value":"1","disabled":true,"description":"Page to return (page x num/10 ≤ 5); pages 1..page are fetched and charged"},{"key":"tbs","value":"","disabled":true,"description":"Recency filter (also accepted: `timeRange`: hour|day|week|month|year)"},{"key":"resolveLinks","value":"true","disabled":true,"description":"Replace Google redirect links with final URLs (see `linksPending`)"},{"key":"autocorrect","value":"false","disabled":true,"description":"Accepted for compatibility; no effect"},{"key":"noCache","value":"false","disabled":true,"description":"Skip the 1-hour result cache"},{"key":"async","value":"false","disabled":true,"description":"Answer 202 at once; poll GET /requests/{requestId}"},{"key":"timeout","value":"60","disabled":true,"description":"Seconds to wait before answering 202"}]}}},{"name":"Image search","request":{"method":"POST","description":"Google Images results with full-size image URLs.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/images","host":["{{baseUrl}}"],"path":["images"]},"body":{"mode":"raw","raw":"{\n  \"q\": \"golden retriever\",\n  \"gl\": \"us\",\n  \"hl\": \"en\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Image search (GET)","request":{"method":"GET","description":"Google Images results with full-size image URLs. Same as the POST endpoint, with the parameters in the query string.","header":[],"url":{"raw":"{{baseUrl}}/images?q=coffee","host":["{{baseUrl}}"],"path":["images"],"query":[{"key":"q","value":"coffee","disabled":false,"description":"Search query"},{"key":"gl","value":"us","disabled":true,"description":"Country (2-letter code)"},{"key":"hl","value":"en","disabled":true,"description":"Interface language"},{"key":"pages","value":"1","disabled":true,"description":"Result pages / scroll loads to fetch; each costs 1 credit"},{"key":"tbs","value":"","disabled":true,"description":"Recency filter (also accepted: `timeRange`: hour|day|week|month|year)"},{"key":"autocorrect","value":"false","disabled":true,"description":"Accepted for compatibility; no effect"},{"key":"noCache","value":"false","disabled":true,"description":"Skip the 1-hour result cache"},{"key":"async","value":"false","disabled":true,"description":"Answer 202 at once; poll GET /requests/{requestId}"},{"key":"timeout","value":"60","disabled":true,"description":"Seconds to wait before answering 202"}]}}},{"name":"News search","request":{"method":"POST","description":"Google News tab results with source and publish time.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/news","host":["{{baseUrl}}"],"path":["news"]},"body":{"mode":"raw","raw":"{\n  \"q\": \"electric vehicles\",\n  \"gl\": \"us\",\n  \"hl\": \"en\",\n  \"num\": 10\n}","options":{"raw":{"language":"json"}}}}},{"name":"News search (GET)","request":{"method":"GET","description":"Google News tab results with source and publish time. Same as the POST endpoint, with the parameters in the query string.","header":[],"url":{"raw":"{{baseUrl}}/news?q=coffee","host":["{{baseUrl}}"],"path":["news"],"query":[{"key":"q","value":"coffee","disabled":false,"description":"Search query"},{"key":"gl","value":"us","disabled":true,"description":"Country (2-letter code)"},{"key":"hl","value":"en","disabled":true,"description":"Interface language"},{"key":"num","value":"10","disabled":true,"description":"Results per page; each 10 costs 1 credit"},{"key":"page","value":"1","disabled":true,"description":"Page to return (page x num/10 ≤ 5); pages 1..page are fetched and charged"},{"key":"tbs","value":"","disabled":true,"description":"Recency filter (also accepted: `timeRange`: hour|day|week|month|year)"},{"key":"resolveLinks","value":"true","disabled":true,"description":"Replace Google redirect links with final URLs (see `linksPending`)"},{"key":"includeThumbnails","value":"false","disabled":true,"description":"Include inline base64 thumbnails (~20 KB each)"},{"key":"autocorrect","value":"false","disabled":true,"description":"Accepted for compatibility; no effect"},{"key":"noCache","value":"false","disabled":true,"description":"Skip the 1-hour result cache"},{"key":"async","value":"false","disabled":true,"description":"Answer 202 at once; poll GET /requests/{requestId}"},{"key":"timeout","value":"60","disabled":true,"description":"Seconds to wait before answering 202"}]}}},{"name":"Video search","request":{"method":"POST","description":"Google Videos tab results with duration and channel.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/videos","host":["{{baseUrl}}"],"path":["videos"]},"body":{"mode":"raw","raw":"{\n  \"q\": \"python asyncio tutorial\",\n  \"gl\": \"us\",\n  \"hl\": \"en\",\n  \"num\": 10\n}","options":{"raw":{"language":"json"}}}}},{"name":"Video search (GET)","request":{"method":"GET","description":"Google Videos tab results with duration and channel. Same as the POST endpoint, with the parameters in the query string.","header":[],"url":{"raw":"{{baseUrl}}/videos?q=coffee","host":["{{baseUrl}}"],"path":["videos"],"query":[{"key":"q","value":"coffee","disabled":false,"description":"Search query"},{"key":"gl","value":"us","disabled":true,"description":"Country (2-letter code)"},{"key":"hl","value":"en","disabled":true,"description":"Interface language"},{"key":"num","value":"10","disabled":true,"description":"Results per page; each 10 costs 1 credit"},{"key":"page","value":"1","disabled":true,"description":"Page to return (page x num/10 ≤ 5); pages 1..page are fetched and charged"},{"key":"tbs","value":"","disabled":true,"description":"Recency filter (also accepted: `timeRange`: hour|day|week|month|year)"},{"key":"includeThumbnails","value":"false","disabled":true,"description":"Include inline base64 thumbnails (~20 KB each)"},{"key":"autocorrect","value":"false","disabled":true,"description":"Accepted for compatibility; no effect"},{"key":"noCache","value":"false","disabled":true,"description":"Skip the 1-hour result cache"},{"key":"async","value":"false","disabled":true,"description":"Answer 202 at once; poll GET /requests/{requestId}"},{"key":"timeout","value":"60","disabled":true,"description":"Seconds to wait before answering 202"}]}}},{"name":"Shopping search","request":{"method":"POST","description":"Google Shopping products with price and rating.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/shopping","host":["{{baseUrl}}"],"path":["shopping"]},"body":{"mode":"raw","raw":"{\n  \"q\": \"mechanical keyboard\",\n  \"gl\": \"us\",\n  \"hl\": \"en\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Shopping search (GET)","request":{"method":"GET","description":"Google Shopping products with price and rating. Same as the POST endpoint, with the parameters in the query string.","header":[],"url":{"raw":"{{baseUrl}}/shopping?q=coffee","host":["{{baseUrl}}"],"path":["shopping"],"query":[{"key":"q","value":"coffee","disabled":false,"description":"Search query"},{"key":"gl","value":"us","disabled":true,"description":"Country (2-letter code)"},{"key":"hl","value":"en","disabled":true,"description":"Interface language"},{"key":"pages","value":"1","disabled":true,"description":"Result pages / scroll loads to fetch; each costs 1 credit"},{"key":"includeThumbnails","value":"false","disabled":true,"description":"Include inline base64 thumbnails (~20 KB each)"},{"key":"autocorrect","value":"false","disabled":true,"description":"Accepted for compatibility; no effect"},{"key":"noCache","value":"false","disabled":true,"description":"Skip the 1-hour result cache"},{"key":"async","value":"false","disabled":true,"description":"Answer 202 at once; poll GET /requests/{requestId}"},{"key":"timeout","value":"60","disabled":true,"description":"Seconds to wait before answering 202"}]}}},{"name":"Places search","request":{"method":"POST","description":"Local results (the Places tab) with rating and address.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/places","host":["{{baseUrl}}"],"path":["places"]},"body":{"mode":"raw","raw":"{\n  \"q\": \"coffee shop hanoi\",\n  \"gl\": \"us\",\n  \"hl\": \"en\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Places search (GET)","request":{"method":"GET","description":"Local results (the Places tab) with rating and address. Same as the POST endpoint, with the parameters in the query string.","header":[],"url":{"raw":"{{baseUrl}}/places?q=coffee","host":["{{baseUrl}}"],"path":["places"],"query":[{"key":"q","value":"coffee","disabled":false,"description":"Search query"},{"key":"gl","value":"us","disabled":true,"description":"Country (2-letter code)"},{"key":"hl","value":"en","disabled":true,"description":"Interface language"},{"key":"pages","value":"1","disabled":true,"description":"Result pages / scroll loads to fetch; each costs 1 credit"},{"key":"includeThumbnails","value":"false","disabled":true,"description":"Include inline base64 thumbnails (~20 KB each)"},{"key":"autocorrect","value":"false","disabled":true,"description":"Accepted for compatibility; no effect"},{"key":"noCache","value":"false","disabled":true,"description":"Skip the 1-hour result cache"},{"key":"async","value":"false","disabled":true,"description":"Answer 202 at once; poll GET /requests/{requestId}"},{"key":"timeout","value":"60","disabled":true,"description":"Seconds to wait before answering 202"}]}}},{"name":"Maps search","request":{"method":"POST","description":"Google Maps places with coordinates, place id and CID.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/maps","host":["{{baseUrl}}"],"path":["maps"]},"body":{"mode":"raw","raw":"{\n  \"q\": \"pho restaurant hanoi\",\n  \"gl\": \"us\",\n  \"hl\": \"en\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Maps search (GET)","request":{"method":"GET","description":"Google Maps places with coordinates, place id and CID. Same as the POST endpoint, with the parameters in the query string.","header":[],"url":{"raw":"{{baseUrl}}/maps?q=coffee","host":["{{baseUrl}}"],"path":["maps"],"query":[{"key":"q","value":"coffee","disabled":false,"description":"Search query"},{"key":"gl","value":"us","disabled":true,"description":"Country (2-letter code)"},{"key":"hl","value":"en","disabled":true,"description":"Interface language"},{"key":"pages","value":"1","disabled":true,"description":"Result pages / scroll loads to fetch; each costs 1 credit"},{"key":"autocorrect","value":"false","disabled":true,"description":"Accepted for compatibility; no effect"},{"key":"noCache","value":"false","disabled":true,"description":"Skip the 1-hour result cache"},{"key":"async","value":"false","disabled":true,"description":"Answer 202 at once; poll GET /requests/{requestId}"},{"key":"timeout","value":"60","disabled":true,"description":"Seconds to wait before answering 202"}]}}}]},{"name":"Requests","item":[{"name":"Poll a request","request":{"method":"GET","description":"Result of a request answered `202` (or any earlier request): `202` while pending, then the same\nbody as the search endpoint. Only the account that made the request can read it.","header":[],"url":{"raw":"{{baseUrl}}/requests/{{requestId}}","host":["{{baseUrl}}"],"path":["requests","{{requestId}}"]}}}]},{"name":"Account","item":[{"name":"Credit balance","request":{"method":"GET","description":"Credit balance of the account that owns the key, with its live grants (soonest expiry first).","header":[],"url":{"raw":"{{baseUrl}}/account","host":["{{baseUrl}}"],"path":["account"]}}}]}]}