{ "openapi": "3.1.0", "info": { "title": "Outscraper API Docs", "description": "**SDKs**\n\nThe supported list of official SDKs: [Python](https://pypi.org/project/outscraper/), [Ruby](https://github.com/outscraper/outscraper-ruby), [PHP](https://packagist.org/packages/outscraper/outscraper), [Node](https://www.npmjs.com/package/outscraper), [Go](https://github.com/outscraper/outscraper-go), and [Java](https://github.com/outscraper/outscraper-java). Check out the [Outscraper GitHub page](https://github.com/outscraper) to learn more about SDKs and find more code examples.\n\n**QPS & Limits**\n\nThe limit of queries per second depends on the nature of the requests, service, and request parameters (amount of results, amount of queries, etc.). The average QPS is about `20`. However, Outscraper can scale according to your needs. Please contact the team in case you need higher QPS.\n\n[F.A.Q](https://outscraper.com/faq/#API)", "version": "0.4.3" }, "servers": [ { "url": "https://api.outscraper.cloud" } ], "x-tagGroups": [ { "name": "By Type", "tags": ["Businesses & POI", "Reviews & Comments", "Products & Listings", "Email Related", "Phone Related", "Domain Related", "Business Data API", "Other Services"] }, { "name": "By Brand", "tags": ["Amazon", "Booking", "Capterra", "Facebook", "Google", "Trustpilot", "ProductHunt", "YouTube", "Others"] }, { "name": "System", "tags": ["Requests", "Platform & Dashboard"] } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-KEY", "description": "The Outscraper API uses API keys (tokens) to authenticate requests. You can view and manage your API key on [the account page](/account/api).\n\nAuthentication to the API is performed via `X-API-KEY: YOUR-API-KEY` header inside each request.\n\nAlternatively, you can send the API key inside URL query parameters `apiKey=YOUR-API-KEY`. Although, this method less secure and recommended for testing purposes only.\n\nYour API keys carry various privileges, do not share them in public areas such as GitHub, client-side code, and so forth." }, "APIKeyQueryParam": { "type": "apiKey", "in": "query", "name": "apiKey", "description": "Alternatively, you can send the API key inside URL query parameters `apiKey=YOUR-API-KEY`. Although, this method less secure and recommended for testing purposes only." } }, "schemas": { "language": { "type": "string", "enum": [ "en", "de", "es", "es-419", "fr", "hr", "it", "nl", "pl", "pt-BR", "pt-PT", "vi", "tr", "ru", "ar", "th", "ko", "zh-CN", "zh-TW", "ja", "ach", "af", "ak", "ig", "az", "ban", "ceb", "xx-bork", "bs", "br", "ca", "cs", "sn", "co", "cy", "da", "yo", "et", "xx-elmer", "eo", "eu", "ee", "tl", "fil", "fo", "fy", "gaa", "ga", "gd", "gl", "gn", "xx-hacker", "ht", "ha", "haw", "bem", "rn", "id", "ia", "xh", "zu", "is", "jw", "rw", "sw", "tlh", "kg", "mfe", "kri", "la", "lv", "to", "lt", "ln", "loz", "lua", "lg", "hu", "mg", "mt", "mi", "ms", "pcm", "no", "nso", "ny", "nn", "uz", "oc", "om", "xx-pirate", "ro", "rm", "qu", "nyn", "crs", "sq", "sk", "sl", "so", "st", "sr-ME", "sr-Latn", "su", "fi", "sv", "tn", "tum", "tk", "tw", "wo", "el", "be", "bg", "ky", "kk", "mk", "mn", "sr", "tt", "tg", "uk", "ka", "hy", "yi", "iw", "ug", "ur", "ps", "sd", "fa", "ckb", "ti", "am", "ne", "mr", "hi", "bn", "pa", "gu", "or", "ta", "te", "kn", "ml", "si", "lo", "my", "km", "chr" ], "default": "en" }, "region": { "type": "string", "enum": [ "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AG", "AR", "AM", "AU", "AT", "AZ", "BS", "BH", "BD", "BY", "BE", "BZ", "BJ", "BT", "BO", "BA", "BW", "BR", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "CF", "TD", "CL", "CN", "CO", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "EE", "ET", "FJ", "FI", "FR", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GT", "GG", "GY", "HT", "HN", "HK", "HU", "IS", "IN", "ID", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LY", "LI", "LT", "LU", "MG", "MW", "MY", "MV", "ML", "MT", "MU", "MX", "FM", "MD", "MN", "ME", "MS", "MA", "MQ", "MZ", "MM", "NA", "NR", "NP", "NL", "NZ", "NI", "NE", "NG", "NU", "MK", "NO", "OM", "PK", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RU", "RW", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "KR", "ES", "LK", "SH", "VC", "SR", "SE", "CH", "TW", "TJ", "TZ", "TH", "TL", "TG", "TO", "TT", "TN", "TR", "TM", "VI", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VE", "VN", "ZM", "ZW" ] }, "parameters": { "async": { "in": "query", "name": "async", "required": true, "description": "The parameter defines the way you want to submit your task to Outscraper. It can be set to `false` to open an HTTP connection and keep it open until you got your results, or `true` (default) to just submit your requests to Outscraper and retrieve them later (usually within 1-3 minutes) with the [Request Results](#tag/requests/GET/requests/{requestId}) endpoint. Each response is available for `4` hours after a request has been completed.\n\nA good practice is to send async requests and start checking the results after the estimated execution time. Check out [this](https://github.com/outscraper/outscraper-python/blob/master/examples/Run%20Async%20Requests.md) Python implementation as an example.\n\nAs most of the requests take some time to be executed the `async=true` option is preferred to avoid HTTP requests timeouts.", "schema": { "type": "boolean", "default": true }, "example": false }, "ui": { "in": "query", "name": "ui", "required": false, "description": "The parameter defines whether a task will be executed as a UI task. This is commonly used when you want to create a regular platform task with API.\n\nUsing this parameter overwrites the `async` parameter to `true`.", "schema": { "type": "boolean", "default": false } }, "format": { "in": "query", "name": "format", "required": false, "description": "The parameter defines the format of the output data. Using this parameter overwrites the `ui` parameter to `true`.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string", "default": "xlsx", "enum": [ "xlsx", "csv", "json", "parquet" ] } } }, "webhook": { "in": "query", "name": "webhook", "required": false, "description": "The parameter defines the URL address (callback) to which Outscraper will create a POST request with a JSON body once a task/request is finished.\n\nUsing this parameter overwrites the webhook from integrations.", "schema": { "type": "string" } }, "fields": { "in": "query", "name": "fields", "required": false, "description": "The parameter defines which fields you want to include with each item returned in the response. By default, it returns all fields. Use `&fields=query,name` to return only the specific ones.", "schema": { "type": "string" } }, "enrichments": { "in": "query", "name": "enrichment", "required": false, "description": "The parameter defines an enrichment or enrichments (e.g., `enrichment=enrichment1&enrichment=enrichment2&enrichment=enrichment3`) you want to apply to the results.\n\nAvailable values:\n\n `contacts_n_leads` — **Contacts & Leads Enrichment**: finds emails, social links, phones, and other contacts from websites;\n\n `emails_validator_service` — **Email Address Verifier**: validates emails, checks deliverability, filters out blacklists, spam traps, and complainers, while significantly reducing your bounce rate;\n\n `company_websites_finder` - **Company Website Finder**: finds company websites based on business names;\n\n `disposable_email_checker` — **Disposable Emails Checker**: checks origins of email addresses (disposable, free, or corporate);\n\n `company_insights_service` — **Company Insights**: Finds company firmographics such as revenue, size, founding year, public status, etc.;\n\n `phones_enricher_service` — **Phone Numbers Enricher**: returns phones carrier data (name/type), validates phones, ensures messages deliverability, \n\n `trustpilot_service` — **Trustpilot Scraper**: returns data from a list of businesses, \n\n `whitepages_phones` - **Phone Identity Finder**: returns insights about phone number owners (name, address, etc.);\n\n `ai_chain_info` - **Chain Info**: identifies if a business is part of a chain, adding a true/false indication to your data for smarter targeting. \n\nUsing enrichments increases the time of the response. You might want to use the `async=true` parameter to avoid getting timeouts.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, "preferredContacts": { "in": "query", "name": "preferredContacts", "description": "Preferred contacts. It supports multiple categories (e.g., `preferredContacts=technical&preferredContacts=influencers`).", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string", "enum": [ "decision makers", "influencers", "procurement/purchasing", "technical", "finance", "operations", "marketing", "sales", "maintenance", "human resources", "legal and compliance", "supply chain/logistics", "education/training" ] } } }, "contactsPerCompany": { "in": "query", "name": "contactsPerCompany", "description": "The parameter specifies the number of Contacts per one company.", "schema": { "type": "integer", "default": 3 } }, "skipContacts": { "in": "query", "name": "skipContacts", "description": "The parameter specifies the number of contacts to skip. Used for pagination.", "schema": { "type": "integer", "default": 3 } }, "emailsPerContact": { "in": "query", "name": "emailsPerContact", "description": "The parameter specifies the number of email addresses per one contact.", "schema": { "type": "integer", "default": 1 } }, "generalEmails": { "in": "query", "name": "generalEmails", "description": "The parameter specifies whether to include only general email (info@, support@, etc.) or only not general email (paul@, john@, etc.).", "schema": { "type": "boolean", "default": null } }, "language": { "in": "query", "name": "language", "required": false, "description": "The parameter specifies the language to use for website.", "schema": { "$ref": "#/components/schemas/language" } }, "region": { "in": "query", "name": "region", "required": false, "description": "The parameter specifies the country to use for website. It's recommended to use it for a better search experience.", "schema": { "$ref": "#/components/schemas/region" } }, "coordinates": { "in": "query", "name": "coordinates", "required": false, "description": "The parameter defines the coordinates of the location where you want your query to be applied.\n\nIt has to be constructed in the next sequence: `@` + `latitude` + `,` + `longitude` + `,` + `zoom` (`@41.3954381,2.1628662,15.1z`).\nOften, you can find this value while visiting [Google Maps](https://www.google.com/maps/search/restaurants,+Manhattan,+New+York,+NY,+USA/@40.7510123,-73.9803871,13.68z).", "schema": { "type": "string" } }, "coordinates_v2": { "in": "query", "name": "coordinates", "required": false, "description": "The parameter defines the coordinates of the location where you want your query to be applied.\n\nIt has to be constructed in the next sequence: `latitude` + `,` + `longitude` (`41.3954381,2.1628662`).\nOften, you can find this value while visiting [Google Maps](https://www.google.com/maps/search/restaurants,+Manhattan,+New+York,+NY,+USA/@40.7510123,-73.9803871,13.68z).", "schema": { "type": "string" } }, "google_maps_query": { "in": "query", "name": "query", "required": true, "description": "The parameter defines the query you want to search. You can use anything that you would use on a regular Google Maps site. Additionally, you can use `google_id` (feature_id), `place_id`, `CID` or urls to Google Maps places. The example of valid queries: `Real estate agency, Rome, Italy`, `The NoMad Restaurant, NY, USA`, `restaurants, Brooklyn 11203`, `0x886916e8bc273979:0x5141fcb11460b226`, `ChIJu7bMNFV-54gR-lrHScvPRX4`, `https://www.google.com/maps/search/restaurants+near+New+York,+NY`, etc.\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and save on network latency time. \n\nYou might want to check out [the web application](/googleMaps) to play with locations and categories that we would suggest.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, "google_maps_query_v2": { "in": "query", "name": "query", "required": true, "description": "The parameter defines the query you want to search. You can use anything that you would use on a regular Google Maps site. Additionally, you can use `google_id` (feature_id), `place_id`, or `CID`. The example of valid queries: `Real estate agency, Rome, Italy`, `The NoMad Restaurant, NY, USA`, `restaurants, Brooklyn 11203`, `0x886916e8bc273979:0x5141fcb11460b226`, `ChIJrZhup4lZwokRUr_5sLoFlDw`, etc.\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and save on network latency time.\n\nYou might want to check out [the web application](/googleMaps) to play with locations and categories that we would suggest.", "schema": { "type": "string" }, "example": "Restaurants, Manhattan, NY, US" }, "pages_per_query": { "in": "query", "name": "pagesPerQuery", "required": false, "description": "The parameter specifies the limit of pages to return from one query.", "schema": { "type": "integer", "default": 1 } }, "items_per_query": { "in": "query", "name": "perQuery", "required": false, "description": "The parameter specifies the limit of items to return from one query.", "schema": { "type": "integer", "default": 100 } }, "google_search_query": { "in": "query", "name": "query", "required": true, "description": "Queries to search on Google (e.g., `bitcoin`, `37th president of usa`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, "google_search_uule": { "in": "query", "name": "uule", "required": false, "description": "Google UULE parameter is used to encode a place or an exact location (with latitude and longitude) into a code. By using it you can see a Google result page like someone located at the specified location.", "schema": { "type": "string" } }, "google_search_tbs": { "in": "query", "name": "tbs", "required": false, "description": "The parameter specifies the date range of the results (`h` - past hour, `d` - past 24 hours, `w` - past week, `m` - past month, 'y' - past year).", "schema": { "type": "string", "enum": [ "h", "d", "w", "m", "y" ] } }, "cutoff": { "in": "query", "name": "cutoff", "required": false, "description": "The parameter specifies the oldest timestamp value for items. \n\nUsing the `cutoff` parameter overwrites `sort` parameter`. Therefore, the latest records will be at the beginning (newest first).", "schema": { "type": "integer" } }, "skip": { "in": "query", "name": "skip", "required": false, "description": "The parameter specifies the number of items to skip. Used for pagination.", "schema": { "type": "integer", "default": 0 } }, "skip20multiple": { "in": "query", "name": "skip", "required": false, "description": "Number of items to skip. Must be a multiple of 20 (e.g., 0, 20, 40). Used for pagination.", "schema": { "type": "integer", "default": 0 } }, "last_pagination_id": { "in": "query", "name": "lastPaginationId", "required": false, "description": "The parameter specifies the review_pagination_id of the last item. Used for pagination.", "schema": { "type": "string" } }, "maps_limit": { "in": "query", "name": "limit", "required": true, "description": "The parameter specifies the limit of organizations to take from one query search.\n\nThere are no more than 500 places per one query search on Google Maps. For densely populated areas you might want to split your query into subqueries in order to get all the places inside. (e.g., `restaurants, Brooklyn 11211`, `restaurants, Brooklyn 11215`).", "schema": { "type": "integer", "default": 500 }, "example": 25 }, "maps_total_limit": { "in": "query", "name": "totalLimit", "required": false, "description": "The parameter specifies the total limit of organizations to take from many queries. Usefull when using `dropDuplicates` parameter. It allows you to limit the total amount of organizations returned from all queries inside one request.", "schema": { "type": "integer" } }, "maps_drop_duplicates": { "in": "query", "name": "dropDuplicates", "required": false, "description": "The parameter specifies whether the bot will drop the same organizations from different queries. It makes sense when you use batching and send multiple queries inside one request.\n\nUsing the parameter combines results from each query inside one big array (`{'data': [...]}` instead of `{'data': [[...], [...], [...]]}`).\n\nIf the amount of ignored rows are less than 5,000% of what was actually extracted, you won't be billed for ignored records.", "schema": { "type": "boolean", "default": false } }, "maps_reviews_reviews_limit": { "in": "query", "name": "reviewsLimit", "required": false, "description": "The parameter specifies the limit of reviews to get from one place (0 = unlimited).", "schema": { "type": "integer", "default": 100 } }, "maps_reviews_limit": { "in": "query", "name": "limit", "required": false, "description": "The parameter specifies the limit of places to take from one query search.", "schema": { "type": "integer", "default": 1 } }, "maps_reviews_sort": { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "most_relevant", "newest", "highest_rating", "lowest_rating" ], "default": "most_relevant" } }, "amazon_domain": { "in": "query", "name": "domain", "required": false, "description": "The parameter specifies Amazon domain to use.", "schema": { "type": "string", "enum": [ "amazon.com", "amazon.co.uk", "amazon.ca", "amazon.de", "amazon.es", "amazon.fr", "amazon.it", "amazon.in", "amazon.nl", "amazon.se", "amazon.sa", "amazon.com.mx", "amazon.com.br", "amazon.com.au", "amazon.co.jp", "amazon.pl", "amazon.ae" ], "default": "amazon.com" } }, "maps_reviews_query": { "in": "query", "name": "reviewsQuery", "required": false, "description": "The parameter specifies the query to search among the reviews (e.g. `wow`, `amazing | great`).", "schema": { "type": "string" } }, "maps_reviews_start": { "in": "query", "name": "start", "required": false, "description": "The parameter specifies the start timestamp value for reviews (newest review). The current timestamp is used when the value is not provided.\n\nUsing the `start` parameter overwrites the `sort` parameter to `newest`. Therefore, the latest reviews will be at the beginning.", "schema": { "type": "integer" } }, "maps_reviews_cutoff": { "in": "query", "name": "cutoff", "required": false, "description": "The parameter specifies the oldest timestamp value for reviews (oldest review). \n\nUsing the `cutoff` parameter overwrites `sort` parameter to `newest`. Therefore, the latest reviews will be at the beginning.", "schema": { "type": "integer" } }, "maps_reviews_cutoff_rating": { "in": "query", "name": "cutoffRating", "required": false, "description": "The parameter specifies the maximum for `lowest_rating` sorting or the minimum for `highest_rating` sorting rating for reviews.\n\nUsing the `cutoffRating` requires sorting to be set to `lowest_rating` or `highest_rating`.", "schema": { "type": "integer" } }, "maps_reviews_cutoff_ignore_empty": { "in": "query", "name": "ignoreEmpty", "required": false, "description": "The parameter specifies whether to ignore reviews without text or not.", "schema": { "type": "boolean", "default": false } }, "reviews_limit": { "in": "query", "name": "limit", "required": false, "description": "The parameter specifies the limit of reviews to get from one query.", "schema": { "type": "integer", "default": 100 } }, "cursor": { "in": "query", "name": "cursor", "required": false, "description": "The parameter specifies the next page cursor (`next_page_cursor`) from the previous chunk of records (usually `10`). Used for pagination.", "schema": { "type": "string" } }, "limit": { "in": "query", "name": "limit", "required": false, "description": "The parameter specifies the limit of items to get from one query.", "schema": { "type": "integer", "default": 100 } }, "businesses_filters": { "type": "object", "description": "Filtering criteria to narrow down business records.", "properties": { "os_ids": { "type": "array", "description": "List of Outscraper business IDs (os_id) to include.", "items": { "type": "string" }, "example": ["b3c1f2a0d9e84f0a6c3b9d2f4e7a1c90", "9f1a2b3c4d5e6f708192a3b4c5d6e7f8"] }, "country_code": { "type": "string", "description": "Two-letter country code to filter businesses by country (e.g., 'US', 'GB', 'CA').", "example": "US" }, "states": { "type": "array", "description": "List of states or provinces to filter businesses by.", "items": { "type": "string" }, "example": ["CA", "NY"] }, "cities": { "type": "array", "description": "List of cities to filter businesses by.", "items": { "type": "string" }, "example": ["Los Angeles", "New York"] }, "counties": { "type": "array", "description": "List of counties/boroughs to filter businesses by.", "items": { "type": "string" }, "example": ["Kings County", "Queens County"] }, "postal_codes": { "type": "array", "description": "List of postal/ZIP codes to filter businesses by (full or partial).", "items": { "type": "string" }, "example": ["10001", "90"] }, "name": { "type": "string", "description": "Business name filter (partial or full match).", "example": "Starbucks" }, "name_exclude": { "type": "boolean", "description": "Whether to exclude businesses matching the `name` filter (`true`) or include them (`false`).", "example": true }, "types": { "type": "array", "description": "List of business categories to include (e.g., 'restaurant', 'dentist', 'hotel').", "items": { "type": "string" }, "example": ["restaurant", "cafe"] }, "ignore_types": { "type": "array", "description": "List of business categories to exclude from results.", "items": { "type": "string" }, "example": ["bar", "night_club"] }, "rating": { "type": "string", "description": "Rating filter expression.", "example": "4.5+" }, "reviews": { "type": "string", "description": "Reviews count filter expression.", "example": "100+" }, "has_website": { "type": "boolean", "description": "Whether the business has a website (`true`) or not (`false`).", "example": true }, "domain": { "type": "string", "description": "Website domain to filter businesses by (e.g., 'example.com').", "example": "example.com" }, "has_phone": { "type": "boolean", "description": "Whether the business has a phone number (`true`) or not (`false`).", "example": true }, "phone": { "type": "string", "description": "Phone number filter (partial or full match).", "example": "14155550123" }, "business_statuses": { "type": "array", "items": { "type": "string", "enum": ["operational", "closed_temporarily", "closed_permanently"] }, "description": "Business status filter.", "example": ["operational"] }, "area_service": { "type": "boolean", "description": "Whether the business is marked as an area service business.", "example": false }, "verified": { "type": "boolean", "description": "Whether the business is verified.", "example": true }, "geo_filters": { "type": "array", "description": "List of geo filter objects (e.g., polygons, circles, bounding boxes).", "items": { "type": "object" }, "example": [ { "type": "circle", "lat": 34.0522, "lng": -118.2437, "radius_m": 2000 } ] }, "attributes": { "type": "array", "description": "List of business attributes to filter by.", "items": { "type": "string" }, "example": ["wheelchair_accessible", "takes_reservations"] }, "located_os_id": { "type": "string", "description": "Location reference Outscraper ID used to filter nearby/related businesses.", "example": "b3c1f2a0d9e84f0a6c3b9d2f4e7a1c90" }, "broad_match": { "type": "boolean", "description": "Whether to use broader matching for text/category filters.", "example": false }, "business_only": { "type": "boolean", "description": "Whether to return only businesses (exclude other entity types).", "example": true } } } }, "responses": { "202": { "description": "The response contains a request ID that can be used to fetch results by using [Request Results](#tag/requests/GET/requests/{requestId}) endpoint. Each response is available for `4` hours after a request has been completed.", "content": { "application/json": { "example": { "id": "your-request-id", "status": "Pending", "results_location": "https://api.outscraper.cloud/requests/your-request-id" } } } }, "204": { "description": "The request was finished with failure and has no results.", "content": { "application/json": { "example": { "id": "your-request-id", "status": "Failure" } } } }, "401": { "description": "Wrong or missing API Key (token).", "content": { "application/json": { "example": { "error": true, "errorMessage": "401 Unauthorized: The server could not verify that you are authorized to access the URL requested. You either supplied the wrong credentials (e.g. a bad password), or your browser doesn't understand how to supply the credentials required." } } } }, "402": { "description": "Past due invoices or a payment method not connected.", "content": { "application/json": { "example": { "error": true, "errorMessage": "Please close past due invoices or verify your card information is correct." } } } }, "422": { "description": "Wrong query url parameters.", "content": { "application/json": { "example": { "error": true, "errorMessage": "422 Unprocessable Entity: The request was well-formed but was unable to be followed due to semantic errors." } } } } }, "results": { "description": {"common": "The response contains the `status` of the request and `data`. Data is an array where each element represents a response for a single query from the request."}, "google_maps": {"id":"your-request-id","status":"Success","data":[[{"query":"restaurants, Manhattan, NY, USA","name":"Upland","place_id":"ChIJWVD7FadZwokRs_pS6XY7VOU","google_id":"0x89c259a715fb5059:0xe5543b76e952fab3","full_address":"345 Park Ave S, New York, NY 10010","borough":"Manhattan","street":"345 Park Ave S","postal_code":"10010","area_service":false,"country_code":"US","country":"United States of America","city":"New York","us_state":"New York","state":"New York","plus_code":null,"latitude":40.7419313,"longitude":-73.984644,"time_zone":"America/New_York","popular_times":null,"site":"https://uplandnyc.com/?utm_source=Google+My+Business&utm_medium=Website+Button","phone":"+1 212-686-1006","type":"Californian restaurant","logo":"https://lh4.googleusercontent.com/-zvSnhN_Mek4/AAAAAAAAAAI/AAAAAAAAAAA/XHbA606mawk/s44-p-k-no-ns-nd/photo.jpg","description":"Spacious, casually chic brasserie with hearty dishes featuring Californian & Italian influences.","located_in":null,"located_google_id":null,"category":"Californian restaurant","subtypes":"Californian restaurant, American restaurant, Bar, Italian restaurant, Takeout Restaurant, Restaurant","posts":null,"reviews_tags":null,"rating":4.5,"reviews":1766,"photos_count":4255,"cid":"16524898314635901619","reviews_link":"https://search.google.com/local/reviews?placeid=ChIJWVD7FadZwokRs_pS6XY7VOU&q=restaurants,+Manhattan,+NY,+USA&authuser=0&hl=en&gl=US","reviews_id":"-1921845759073649997","photo":"https://lh5.googleusercontent.com/p/AF1QipPFzGn4Ie2huHtDmrAmxl0GkSIp5rrXipoxPF55=w800-h500-k-no","street_view":"https://lh5.googleusercontent.com/p/AF1QipPFzGn4Ie2huHtDmrAmxl0GkSIp5rrXipoxPF55=w1600-h1000-k-no","working_hours_old_format":"Monday: 11:30\u202fAM-3\u202fPM,5-10\u202fPM | Tuesday: 11:30\u202fAM-3\u202fPM,5-10\u202fPM | Wednesday: 11:30\u202fAM-3\u202fPM,5-10\u202fPM | Thursday: 11:30\u202fAM-3\u202fPM,5-10\u202fPM | Friday: 11:30\u202fAM-3\u202fPM,5-11\u202fPM | Saturday: 10\u202fAM-3\u202fPM,5-11\u202fPM | Sunday: 10\u202fAM-3\u202fPM,5-9\u202fPM","working_hours":{"Monday":"11:30\u202fAM-3\u202fPM,5-10\u202fPM","Tuesday":"11:30\u202fAM-3\u202fPM,5-10\u202fPM","Wednesday":"11:30\u202fAM-3\u202fPM,5-10\u202fPM","Thursday":"11:30\u202fAM-3\u202fPM,5-10\u202fPM","Friday":"11:30\u202fAM-3\u202fPM,5-11\u202fPM","Saturday":"10\u202fAM-3\u202fPM,5-11\u202fPM","Sunday":"10\u202fAM-3\u202fPM,5-9\u202fPM"},"other_hours":[{"lunch":{"Monday":"11:30\u202fAM-3\u202fPM","Tuesday":"11:30\u202fAM-3\u202fPM","Wednesday":"11:30\u202fAM-3\u202fPM","Thursday":"11:30\u202fAM-3\u202fPM","Friday":"11:30\u202fAM-3\u202fPM","Saturday":"Closed","Sunday":"Closed"}},{"dinner":{"Monday":"5-10\u202fPM","Tuesday":"5-10\u202fPM","Wednesday":"5-10\u202fPM","Thursday":"5-10\u202fPM","Friday":"5-10\u202fPM","Saturday":"5-10\u202fPM","Sunday":"5-9\u202fPM"}},{"delivery":{"Monday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Tuesday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Wednesday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Thursday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Friday":"Closed","Saturday":"Closed","Sunday":"11\u202fAM-3\u202fPM,5-10\u202fPM"}},{"takeout":{"Monday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Tuesday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Wednesday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Thursday":"11:30\u202fAM-3:30\u202fPM,5-10\u202fPM","Friday":"Closed","Saturday":"Closed","Sunday":"11\u202fAM-3\u202fPM,5-10\u202fPM"}},{"brunch":{"Monday":"Closed","Tuesday":"Closed","Wednesday":"Closed","Thursday":"Closed","Friday":"Closed","Saturday":"10\u202fAM-3\u202fPM","Sunday":"10\u202fAM-3\u202fPM"}}],"business_status":"OPERATIONAL","about":{"Service options":{"Delivery":true,"Takeout":true,"Dine-in":true},"Highlights":{"Great coffee":true,"Great dessert":true,"Great tea selection":true},"Popular for":{"Lunch":true,"Dinner":true,"Solo dining":true},"Accessibility":{"Wheelchair accessible entrance":true,"Wheelchair accessible restroom":true,"Wheelchair accessible seating":true,"Wheelchair accessible parking lot":false},"Offerings":{"Alcohol":true,"Beer":true,"Cocktails":true,"Coffee":true,"Comfort food":true,"Hard liquor":true,"Healthy options":true,"Late-night food":true,"Small plates":true,"Vegetarian options":true,"Wine":true},"Dining options":{"Brunch":true,"Lunch":true,"Dinner":true,"Dessert":true,"Seating":true},"Amenities":{"Bar onsite":true,"High chairs":true,"Restroom":true,"Wi-Fi":true},"Atmosphere":{"Romantic":true,"Upscale":true},"Crowd":{"Family-friendly":true,"Groups":true,"LGBTQ+ friendly":true,"Tourists":true,"Transgender safespace":true},"Planning":{"Lunch reservations recommended":true,"Dinner reservations recommended":true,"Accepts reservations":true,"Usually a wait":true},"Payments":{"Debit cards":true,"Credit cards":true},"Other":{"LGBTQ+ friendly":true}},"range":"$$$","reviews_per_score":{"1":50,"2":35,"3":113,"4":394,"5":1174},"reservation_links":["https://resy.com/cities/ny/upland","https://uplandnyc.com/?utm_source=Google%20My%20Business&utm_medium=Reservation%20Button"],"booking_appointment_link":"https://resy.com/cities/ny/upland","menu_link":null,"order_links":null,"owner_id":"111762591187585073824","verified":true,"owner_title":"Upland","owner_link":"https://www.google.com/maps/contrib/111762591187585073824","location_link":"https://www.google.com/maps/place/Upland/@40.7419313,-73.984644,14z/data=!4m8!1m2!2m1!1sUpland!3m4!1s0x89c259a715fb5059:0xe5543b76e952fab3!8m2!3d40.7419313!4d-73.984644"},{"query":"restaurants, Manhattan, NY, USA","name":"Scarpetta","place_id":"ChIJt8W7n79ZwokRsyXs3QDbE3o","google_id":"0x89c259bf9fbbc5b7:0x7a13db00ddec25b3","full_address":"88 Madison Ave, New York, NY 10016","borough":"Manhattan","street":"88 Madison Ave","postal_code":"10016","area_service":false,"country_code":"US","country":"United States of America","city":"New York","us_state":"New York","state":"New York","plus_code":null,"latitude":40.7445818,"longitude":-73.9856202,"time_zone":"America/New_York","popular_times":null,"site":"https://www.scarpettarestaurants.com/location/scarpetta-new-york-city/","phone":"+1 212-691-0555","type":"Italian restaurant","logo":"https://lh3.googleusercontent.com/-PlU2AkPmFYA/AAAAAAAAAAI/AAAAAAAAAAA/Ecs5bmGchRU/s44-p-k-no-ns-nd/photo.jpg","description":"Handmade pastas headline a sophisticated Italian menu at this upscale locale with a cool vibe.","located_in":null,"located_google_id":null,"category":"restaurants","subtypes":"Italian restaurant, Bar, Cocktail bar, Meat dish restaurant, Restaurant, Seafood restaurant, Vegetarian restaurant, Wine bar","posts":null,"reviews_tags":null,"rating":4.4,"reviews":1734,"photos_count":2511,"cid":"8796615293954434483","reviews_link":"https://search.google.com/local/reviews?placeid=ChIJt8W7n79ZwokRsyXs3QDbE3o&q=restaurants,+Manhattan,+NY,+USA&authuser=0&hl=en&gl=US","reviews_id":"8796615293954434483","photo":"https://lh5.googleusercontent.com/p/AF1QipO1zbH5T9c9zf0OMsJP-8E5Ghwbm9cWlIo8ehqF=w800-h500-k-no","street_view":"https://lh5.googleusercontent.com/p/AF1QipO1zbH5T9c9zf0OMsJP-8E5Ghwbm9cWlIo8ehqF=w1600-h1000-k-no","working_hours_old_format":"Monday: 5:30-9:30\u202fPM | Tuesday: 5:30-10\u202fPM | Wednesday: 5:30-10\u202fPM | Thursday: 5:30-11\u202fPM | Friday: 5:30-11\u202fPM | Saturday: 5-11\u202fPM | Sunday: 5:30-9:30\u202fPM","working_hours":{"Monday":"5:30-9:30\u202fPM","Tuesday":"5:30-10\u202fPM","Wednesday":"5:30-10\u202fPM","Thursday":"5:30-11\u202fPM","Friday":"5:30-11\u202fPM","Saturday":"5-11\u202fPM","Sunday":"5:30-9:30\u202fPM"},"other_hours":[{"lunch":{"Monday":"11:30\u202fAM-2:30\u202fPM","Tuesday":"11:30\u202fAM-2:30\u202fPM","Wednesday":"11:30\u202fAM-2:30\u202fPM","Thursday":"11:30\u202fAM-2:30\u202fPM","Friday":"11:30\u202fAM-2:30\u202fPM","Saturday":"Closed","Sunday":"Closed"}},{"brunch":{"Monday":"Closed","Tuesday":"Closed","Wednesday":"Closed","Thursday":"Closed","Friday":"Closed","Saturday":"Closed","Sunday":"11:30\u202fAM-3\u202fPM"}}],"business_status":"OPERATIONAL","about":{"Service options":{"Outdoor seating":true,"No-contact delivery":true,"Delivery":true,"Takeout":true,"Dine-in":true},"Highlights":{"Great coffee":true,"Great dessert":true},"Popular for":{"Lunch":true,"Dinner":true,"Solo dining":true},"Accessibility":{"Wheelchair accessible elevator":true,"Wheelchair accessible entrance":true,"Wheelchair accessible restroom":true,"Wheelchair accessible seating":true,"Wheelchair accessible parking lot":false},"Offerings":{"Alcohol":true,"Beer":true,"Cocktails":true,"Coffee":true,"Comfort food":true,"Hard liquor":true,"Late-night food":true,"Small plates":true,"Vegetarian options":true,"Wine":true},"Dining options":{"Brunch":true,"Lunch":true,"Dinner":true,"Dessert":true,"Seating":true},"Amenities":{"Bar onsite":true,"High chairs":true,"Restroom":true,"Wi-Fi":true},"Atmosphere":{"Cozy":true,"Romantic":true,"Trending":true,"Upscale":true},"Crowd":{"Groups":true,"Tourists":true},"Planning":{"Lunch reservations recommended":true,"Reservations required":true,"Dinner reservations recommended":true,"Accepts reservations":true,"Usually a wait":true},"Payments":{"Debit cards":true}},"range":"$$$","reviews_per_score":{"1":78,"2":48,"3":105,"4":311,"5":1192},"reservation_links":["https://www.sevenrooms.com/reservations/scarpettanyc/"],"booking_appointment_link":"https://www.sevenrooms.com/reservations/scarpettanyc/","menu_link":null,"order_links":null,"owner_id":"109938846905004437020","verified":true,"owner_title":"Scarpetta","owner_link":"https://www.google.com/maps/contrib/109938846905004437020","location_link":"https://www.google.com/maps/place/Scarpetta/@40.7445818,-73.9856202,14z/data=!4m8!1m2!2m1!1sScarpetta!3m4!1s0x89c259bf9fbbc5b7:0x7a13db00ddec25b3!8m2!3d40.7445818!4d-73.9856202"},{"query":"restaurants, Manhattan, NY, USA","name":"The Smith","place_id":"ChIJbd5El_VYwokRFEtA5j2r7Ls","google_id":"0x89c258f59744de6d:0xbbecab3de6404b14","full_address":"1900 Broadway, New York, NY 10023","borough":"Manhattan","street":"1900 Broadway","postal_code":"10023","area_service":false,"country_code":"US","country":"United States of America","city":"New York","us_state":"New York","state":"New York","plus_code":null,"latitude":40.7716564,"longitude":-73.98164009999999,"time_zone":"America/New_York","popular_times":null,"site":"https://thesmithrestaurant.com/","phone":"+1 212-496-5700","type":"American restaurant","logo":"https://lh4.googleusercontent.com/-fqfbzlCALtQ/AAAAAAAAAAI/AAAAAAAAAAA/5juorAHeJbk/s44-p-k-no-ns-nd/photo.jpg","description":"Lively place for classic American fare & specialty cocktails in spacious digs with a hopping bar.","located_in":null,"located_google_id":null,"category":"restaurants","subtypes":"American restaurant, Breakfast restaurant, Brunch restaurant, Oyster bar restaurant","posts":null,"reviews_tags":null,"rating":4.4,"reviews":4077,"photos_count":3173,"cid":"13541386461940566804","reviews_link":"https://search.google.com/local/reviews?placeid=ChIJbd5El_VYwokRFEtA5j2r7Ls&q=restaurants,+Manhattan,+NY,+USA&authuser=0&hl=en&gl=US","reviews_id":"-4905357611768984812","photo":"https://lh5.googleusercontent.com/p/AF1QipMso9TjAKjpXFNR917LF5Toz_WHj1I4MwsvUo7a=w800-h500-k-no","street_view":"https://lh5.googleusercontent.com/p/AF1QipMso9TjAKjpXFNR917LF5Toz_WHj1I4MwsvUo7a=w1600-h1000-k-no","working_hours_old_format":"Monday: 8\u202fAM-11\u202fPM | Tuesday: 8\u202fAM-11\u202fPM | Wednesday: 8\u202fAM-11\u202fPM | Thursday: 8\u202fAM-11\u202fPM | Friday: 8\u202fAM-12\u202fAM | Saturday: 9\u202fAM-12\u202fAM | Sunday: 9\u202fAM-11\u202fPM","working_hours":{"Monday":"8\u202fAM-11\u202fPM","Tuesday":"8\u202fAM-11\u202fPM","Wednesday":"8\u202fAM-11\u202fPM","Thursday":"8\u202fAM-11\u202fPM","Friday":"8\u202fAM-12\u202fAM","Saturday":"9\u202fAM-12\u202fAM","Sunday":"9\u202fAM-11\u202fPM"},"other_hours":[{"brunch":{"Monday":"Closed","Tuesday":"Closed","Wednesday":"Closed","Thursday":"Closed","Friday":"Closed","Saturday":"9\u202fAM-4\u202fPM","Sunday":"9\u202fAM-4\u202fPM"}}],"business_status":"OPERATIONAL","about":{"Service options":{"Outdoor seating":true,"Curbside pickup":true,"Delivery":true,"Takeout":true,"Dine-in":true},"Highlights":{"Fast service":true,"Great cocktails":true,"Great coffee":true,"Great dessert":true},"Popular for":{"Breakfast":true,"Lunch":true,"Dinner":true,"Solo dining":true},"Accessibility":{"Wheelchair accessible elevator":true,"Wheelchair accessible entrance":true,"Wheelchair accessible restroom":true,"Wheelchair accessible seating":true},"Offerings":{"Alcohol":true,"Beer":true,"Cocktails":true,"Coffee":true,"Comfort food":true,"Happy hour drinks":true,"Happy hour food":true,"Hard liquor":true,"Healthy options":true,"Kids' menu":true,"Late-night food":true,"Organic dishes":true,"Quick bite":true,"Small plates":true,"Wine":true},"Dining options":{"Breakfast":true,"Brunch":true,"Lunch":true,"Dinner":true,"Dessert":true,"Seating":true},"Amenities":{"Bar onsite":true,"Good for kids":true,"High chairs":true,"Restroom":true,"Wi-Fi":true},"Atmosphere":{"Casual":true,"Cozy":true},"Crowd":{"Family-friendly":true,"Groups":true,"Tourists":true},"Planning":{"Lunch reservations recommended":true,"Dinner reservations recommended":true,"Accepts reservations":true,"Usually a wait":true},"Payments":{"NFC mobile payments":true}},"range":"$$","reviews_per_score":{"1":102,"2":96,"3":327,"4":1253,"5":2299},"reservation_links":["https://thesmithrestaurant.com/location/lincoln-square/","https://www.opentable.com/restaurant/profile/98185?ref=1068"],"booking_appointment_link":"https://thesmithrestaurant.com/location/lincoln-square/","menu_link":null,"order_links":null,"owner_id":"103162007826525695972","verified":true,"owner_title":"The Smith","owner_link":"https://www.google.com/maps/contrib/103162007826525695972","location_link":"https://www.google.com/maps/place/The+Smith/@40.7716564,-73.98164009999999,14z/data=!4m8!1m2!2m1!1sThe+Smith!3m4!1s0x89c258f59744de6d:0xbbecab3de6404b14!8m2!3d40.7716564!4d-73.98164009999999"}]]}, "google_search_flight": {}, "google_maps_reviews": {"id":"your-request-id","status":"Success","data":[{"name":"The NoMad Restaurant","full_address":"1170 Broadway, New York, NY 10001","rating":4.7,"reviews":775,"reviews_data":[{"google_id":"0x89c259a60b120b1d:0xec845e2f4e9ce9f0","author_link":"https://www.google.com/maps/contrib/104170839246363926920?hl=en-US","author_title":"Mohamed Alkhouri","author_id":"104170839246363926920","author_image":"https://lh3.googleusercontent.com/a-/AOh14Gia8pJbpg5di2qVBPl-TYOVq2ivAMsgkW9r5YKROFI=s120-c-c0x00000000-cc-rp-mo-ba6-br100","review_text":"This one of the best restaurants in NYC. They have the best food that no one can make like it. Professional services and staff. The chf is the best cooker at all. The drinks and the soft drinks are the best. In short cut, the are all what you looking for if you are hungry or with someone you love. I don't visit the restaurant, but my brother is student there and I trust his tastes. I download the photos from the Google. Thanks to everyone and have a nice meal in the best restaurant.","review_img_url":"https://lh5.googleusercontent.com/p/AF1QipMKASaZtgif3BpoPZ8zmWpOUxA8reNzG3Ukk4SW","review_img_urls":["https://lh5.googleusercontent.com/p/AF1QipMKASaZtgif3BpoPZ8zmWpOUxA8reNzG3Ukk4SW"],"owner_answer":null,"owner_answer_timestamp":null,"owner_answer_timestamp_datetime_utc":null,"review_link":"https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s104170839246363926920!2s0x0:0xec845e2f4e9ce9f0?hl=en-US","review_rating":5,"review_timestamp":1616000898,"review_datetime_utc":"03/17/2021 17:08:18","review_likes":0,"reviews_id":"-1403893626557371920"},{"google_id":"0x89c259a60b120b1d:0xec845e2f4e9ce9f0","author_link":"https://www.google.com/maps/contrib/100439884166244262419?hl=en-US","author_title":"Dong Kyu Kim","author_id":"100439884166244262419","author_image":"https://lh3.googleusercontent.com/a-/AOh14GjkEPOWpXjbS80IEt0brUantU33gb-TwoSmznqZUbA=s120-c-c0x00000000-cc-rp-mo-ba2-br100","review_text":"Great views with great heaters. I felt hot while eating even though they had a perfect outdoor setting with air flowing.\nThe food was great as well as the service.\nMy favorite part of the chicken dinner was the deviled eggs and thigh/leg part of the chicken.\nDessert was also really good!","review_img_url":"https://lh5.googleusercontent.com/p/AF1QipPXomo_OkXx4XD16VyRXBCKepoZ1djXYU01yY9O","review_img_urls":["https://lh5.googleusercontent.com/p/AF1QipPXomo_OkXx4XD16VyRXBCKepoZ1djXYU01yY9O"],"owner_answer":null,"owner_answer_timestamp":null,"owner_answer_timestamp_datetime_utc":null,"review_link":"https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s100439884166244262419!2s0x0:0xec845e2f4e9ce9f0?hl=en-US","review_rating":5,"review_timestamp":1611152718,"review_datetime_utc":"01/20/2021 14:25:18","review_likes":1,"reviews_id":"-1403893626557371920"},{"google_id":"0x89c259a60b120b1d:0xec845e2f4e9ce9f0","author_link":"https://www.google.com/maps/contrib/105269840870997446655?hl=en-US","author_title":"Roseanne Whiteley","author_id":"105269840870997446655","author_image":"https://lh3.googleusercontent.com/a-/AOh14GiaSTU86h8dauTbalOWLg6esfcyI9TfSg8s6Iw4=s120-c-c0x00000000-cc-rp-mo-br100","review_text":"I'm going to this restaurant for the third time, and I've always been pleased with the service they offer. The service was excellent, polite, competent, and knowledgeable. We had a sense of sincere concern from the workers. They were really professional and polite as well. Many thanks! Your restaurant should be strongly recommended! Cheer for your win!","review_img_url":"https://lh3.googleusercontent.com/a-/AOh14GiaSTU86h8dauTbalOWLg6esfcyI9TfSg8s6Iw4","review_img_urls":["https://lh5.googleusercontent.com/a-/AOh14GiaSTU86h8dauTbalOWLg6esfcyI9TfSg8s6Iw4"],"owner_answer":null,"owner_answer_timestamp":null,"owner_answer_timestamp_datetime_utc":null,"review_link":"https://www.google.com/maps/reviews/data=!4m5!14m4!1m3!1m2!1s105269840870997446655!2s0x0:0xec845e2f4e9ce9f0?hl=en-US","review_rating":5,"review_timestamp":1615839713,"review_datetime_utc":"03/15/2021 20:21:53","review_likes":0,"reviews_id":"-1403893626557371920"}],"google_id":"0x89c259a60b120b1d:0xec845e2f4e9ce9f0","place_id":"ChIJHQsSC6ZZwokR8OmcTi9ehOw","reviews_link":"https://search.google.com/local/reviews?placeid=ChIJHQsSC6ZZwokR8OmcTi9ehOw&q=The+NoMad+Restaurant,+NY,+USA&authuser=0&hl=en&gl=US","reviews_id":"-1403893626557371920","reviews_per_score":{"1":9,"2":9,"3":38,"4":124,"5":595},"location_link":"https://www.google.com/maps/place/The+NoMad+Restaurant/@40.7449586,-73.9884885,14z/data=!4m8!1m2!2m1!1sThe+NoMad+Restaurant!3m4!1s0x89c259a60b120b1d:0xec845e2f4e9ce9f0!8m2!3d40.7449586!4d-73.9884885"}]}, "google_maps_photos": {"id":"your-request-id","status":"Success","data":[[{"name":"Trump Tower","place_id":"ChIJrc9T9fpYwokRdvjYRHT8nI4","google_id":"0x89c258faf553cfad:0x8e9cfc7444d8f876","full_address":"725 5th Ave, New York, NY 10022","location_link":"https://www.google.com/maps/place/Trump+Tower/@40.7624284,-73.973794,14z/data=!4m8!1m2!2m1!1sTrump+Tower!3m4!1s0x89c258faf553cfad:0x8e9cfc7444d8f876!8m2!3d40.7624284!4d-73.973794","photos_data":[{"photo_id":"AF1QipOWVDj4328cybOEP6-BsLxnUY7PJL8sW2LNjC9n","photo_url":"https://lh5.googleusercontent.com/p/AF1QipOWVDj4328cybOEP6-BsLxnUY7PJL8sW2LNjC9n","photo_url_big":"https://lh5.googleusercontent.com/p/AF1QipOWVDj4328cybOEP6-BsLxnUY7PJL8sW2LNjC9n=w2048-h2048-k-no","latitude":40.762428410640254,"longitude":-73.97379403006005},{"photo_id":"AF1QipOBtXJqlf8tzHi8lxaEIQJVuPR_hWNnuXjqoZ3S","photo_url":"https://lh5.googleusercontent.com/p/AF1QipOBtXJqlf8tzHi8lxaEIQJVuPR_hWNnuXjqoZ3S","photo_url_big":"https://lh5.googleusercontent.com/p/AF1QipOBtXJqlf8tzHi8lxaEIQJVuPR_hWNnuXjqoZ3S=w2048-h2048-k-no","latitude":40.762428410640254,"longitude":-73.97379403006005},{"photo_id":"AF1QipNDAQVYbZRPCxuL9s4jfgNcEs9dJog-GAiEpsGZ","photo_url":"https://lh5.googleusercontent.com/p/AF1QipNDAQVYbZRPCxuL9s4jfgNcEs9dJog-GAiEpsGZ","photo_url_big":"https://lh5.googleusercontent.com/p/AF1QipNDAQVYbZRPCxuL9s4jfgNcEs9dJog-GAiEpsGZ=w2048-h2048-k-no","latitude":40.762579099999996,"longitude":-73.97426109999999}]}]]}, "google_search": {"id":"your-request-id","status":"Success","data":[{"query":"buy iphone 13 TX","organic_results":[{"link":"https://www.apple.com/shop/buy-iphone/iphone-13-pro","title":"New Buy iPhone 13 Pro - Apple","description":"Get iPhone 13 Pro or iPhone 13 Pro Max for an amazing price with special carrier trade-in offers. Make low monthly payments at 0% APR. Free shipping."},{"link":"https://www.att.com/stores/texas/dallas/new-iphone","title":"Get iPhone 13 Pro Max in Dallas - Texas - ATT","description":"Find the iPhone 13 Pro Max in Dallas from AT&T or shop online & choose a delivery option that suits your needs, including free express shipping & curbside\u00a0..."},{"link":"https://www.verizon.com/stores/texas/houston/west-road-285138/smartphones/apple-iphone-13-pro-max/","title":"Apple Iphone 13 Pro Max in Houston Texas | Verizon","description":"Shop Apple Iphone 13 Pro Max at Verizon in Houston , Texas stores. Find updated store hours, deals and directions to Verizon stores in Houston."},{"link":"https://www.bestbuy.com/site/iphone/shop-iphone-13-models/pcmcat1631714593943.c?id=pcmcat1631714593943","title":"Select iPhone 13 Save up to $800 - Best Buy","description":"Shop Best Buy and choose the iPhone model that's right for you. Select from the iPhone 13 mini, iPhone 13, iPhone 13 Pro and the iPhone 13 Pro Max."},{"link":"https://www.metrobyt-mobile.com/shop/phones/details/Apple-iPhone-13-M1-128GB/194252838198","title":"New Apple iPhone 13 | 5G, Pink, 128GB | Metro by T-Mobile","description":"Switcher Instant Rebate: For a limited time at participating Metro\u00ae by T-Mobile stores, purchase an Phone 13 (128GB) and port-in an existing eligible wireless\u00a0...$629.99 to $829.99In stock"},{"link":"https://www.target.com/p/apple-iphone-13-pro-max/-/A-84616123","title":"Apple Iphone 13 Pro Max - Target","description":"Read reviews and buy Apple iPhone 13 Pro Max at Target. Choose from Same Day Delivery, Drive Up or Order Pickup. Free standard shipping with $35 orders.Rating: 4.650 reviews"},{"link":"https://www.walmart.com/browse/iphone-13/c2hlbGZfaWQ6NzUxNzk0NQieie","title":"iPhone 13 - Walmart","description":"Shop for iPhone 13. Buy products such as iPhone 13 Pro Max (AT&T & Verizon), iPhone 13 Pro (AT&T & Verizon), iPhone 13 (AT&T & Verizon) at Walmart and save."}],"ads":[{"link":"https://buy.gazelle.com/collections/iphone-13-pro-max","title":"iPhone 13 Pro Max Refurbished - iPhone 13 Pro Max Unlocked","description":"Choose Carriers, Colors, Conditions & More. Buy iPhone 13 pro max. Used iPhone 13 Pro Max for Sale From Gazelle\u00ae - Simple, Convenient, Works For Everyone."}],"shopping_results":[{"link":"https://www.verizon.com/smartphones/apple-iphone-13-pro-max/?sku=sku5230109","title":"Title of Apple iPhone 13 ProMax 128 GB in Alpine Green with installment","price":"$0.00","source":"Verizon"},{"link":"https://www.apple.com/us/shop/go/product/MLMT3?cppart=UNLOCKED&cid=aos-us-seo-pla","title":"Title of iPhone 13 - 128GB Blue - Unlocked & SIM Free - Apple","price":"$829.00","source":"Apple"},{"link":"https://www.t-mobile.com/cell-phone/apple-iphone-13-pro-max?sku=194252697719","title":"Title of Apple iPhone 13 Pro Max - Sierra Blue - 1TB (with 24 monthly payments)","price":"$499.99","source":"T-Mobile"}],"related_questions":[{"link":"https://www.apple.com/newsroom/2021/09/apple-offers-more-ways-to-shop-for-the-iphone-13-lineup-ipad-and-ipad-mini/","title":"Can you buy an iPhone 13 instore?","description":"The full iPhone 13 and iPad product lineups will be available in stores and delivered to customers beginning Friday, September 24. With an entirely redesigned online store, shopping with Apple online or in-store is simpler than ever.Sep 16, 2021"},{"link":"https://www.macworld.com/article/540445/iphone-13-buy-now-or-wait.html","title":"Is iPhone 13 available to buy now?","description":"If you don't, there's an easy rule: Apple typically releases new iPhones in September, so don't buy a new iPhone shortly before that. 2021 was no exception\u2014Apple put the iPhone 13 series up for sale on September 24.Feb 4, 2022"},{"link":"https://www.cnet.com/tech/mobile/the-best-iphone-13-deals-are-here-target-best-buy-verizon-and-more/","title":"How much does it cost to buy a iPhone 13?","description":"$799iPhone 13 starts at $799. iPhone 13 Mini starts at $699. iPhone 13 Pro starts at $999.Sep 28, 2021"}]}]}, "google_search_news": {"id":"your-request-id","status":"Success","data":[[{"query":"bitcoin","position":1,"title":"On-chain data flashes Bitcoin buy signals, but the bottom could be under \n$20K","body":"Multiple indicators signal that BTC could be in a \u201cbuy zone\u201d but analysts \ncaution that its price could still dip below $20000.","posted":"1 hour ago","link":"https://cointelegraph.com/news/on-chain-data-flashes-bitcoin-buy-signals-but-the-bottom-could-be-under-20k"},{"query":"bitcoin","position":2,"title":"Crypto\u2019s Future Is Even More Exciting Than Its Present","body":"Panelists at our inaugural cryptocurrency roundtable offer bold predictions \nfor Bitcoin, stablecoins, blockchain, and more.","posted":"49 mins ago","link":"https://www.barrons.com/articles/bitcoin-crypto-blockchain-investing-51653676116"},{"query":"bitcoin","position":3,"title":"One River\u2019s Carbon Neutral Bitcoin ETF Rejected by SEC","body":"Don't miss CoinDesk's Consensus 2022, the must-attend crypto & blockchain \nfestival experience of the year in Austin, TX this June 9-12.","posted":"1 hour ago","link":"https://uk.sports.yahoo.com/news/one-river-carbon-neutral-bitcoin-190209828.html"}]]}, "google_search_events": {"id":"your-request-id","status":"Success","data": []}, "google_search_videos": {"id":"your-request-id","status":"Success","data":[[{"query":"outscraper","position":1,"link":"https://outscraper.com/","title":"Outscraper - get any public data from the internet","body":"Outscraper is providing fast and reliable data on Google Maps locations, in a simple and intuitive interface. The platform has advanced features,\u00a0...Outscraper \u00b7 Outscraper team \u00b7 Feb 9, 2019"},{"query":"outscraper","position":2,"link":"https://outscraper.com/b2b-leads-extractor/","title":"B2B Leads Extractor - Free Tier | Outscraper","body":"Is it legal to scrape data? Scraping and extracting of public data is protected\u00a0...Outscraper \u00b7 Outscraper team \u00b7 Dec 8, 2021"},{"query":"outscraper","position":3,"link":"https://twitter.com/outscraper?lang=en","title":"Outscraper - Twitter","body":"Outscraper is the quickest and the simplest way for professionals to export data from a variety of public sources. To learn more about Outscraper, please vis...Twitter \u00b7 Oct 5, 2021"}]]}, "google_search_images": {"id":"your-request-id","status":"Success","data":[[{"query":"iphone","position":1,"original_image":"","title":"Buy iPhone 11 - Apple","source":"apple.com","source_link":"https://www.apple.com/shop/buy-iphone/iphone-11"},{"query":"iphone","position":2,"original_image":"https://store.storeimages.cdn-apple.com/4982/as-images.apple.com/is/iphone-12-family-select-2021?wid=940&hei=1112&fmt=jpeg&qlt=90&.v=1617135051000","title":"Buy iPhone 12 and iPhone 12 mini - Apple","source":"apple.com","source_link":"https://www.google.com/url?sa=i&url=https%3A%2F%2Fwww.apple.com%2Fshop%2Fbuy-iphone%2Fiphone-12&psig=AOvVaw2uqlbYdMQn4a6OHbkjPPFf&ust=1652790673122000&source=images&cd=vfe&ved=2ahUKEwiLi_mYg-T3AhUeCBAIHWJTCoIQr4kDegUIARDaAQ"},{"query":"iphone","position":3,"original_image":"https://store.storeimages.cdn-apple.com/4982/as-images.apple.com/is/iphone11-black-select-2019?wid=940&hei=1112&fmt=png-alpha&.v=1566956144418","title":"iPhone 11 64GB Black - Apple","source":"apple.com","source_link":"https://www.apple.com/shop/buy-iphone/iphone-11/6.1-inch-display-64gb-black-unlocked"}]]}, "google_search_shopping": {"id":"your-request-id","status":"Success","data":[[{"query":"iphone","position":1,"link":"https://www.google.com/shopping/product/437651240330897754?q=iphone&hl=en&gl=US&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gs_lcp=UvHSLA7Uz640JlchZYoULTOTy09hxrjXrbg1BddDeXJ1L8hKvAxhTGpJh681VIB&prds=eto:10095595960159233791_0,pid:16627194887412580682,rsk:PC_8217023720749633348&sa=X&ved=0ahUKEwjeu_vYub74AhWjj2oFHeQACRYQ8gII4BAoAA","image":"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcT3nKfqR3-wmqMxiSP-9MWZoHC87ST6G_T7ehZ8SNPjNTx62Mt8eAc-tJgSsSn_0PvARuFrq_UY53JOLehu7DMvkwqITL3Lgb2Z3JIZ3usVp-apzrcV-SScsw&usqp=CAE","title":"Apple iPhone 13 Pro Max - 128 GB - Alpine Green","options":"4.69,848","id":"16627194887412580682","source":"Apple","source_link":"https://www.google.com/url?url=https://www.apple.com/us/shop/go/product/MNCP3%3Fcppart%3DUNLOCKED%26cid%3Daos-us-seo-pla&rct=j&q=&esrc=s&sa=U&ved=0ahUKEwjeu_vYub74AhWjj2oFHeQACRYQguUECOkQ&usg=AOvVaw00X6LdGKmQSLn67LlB6LPP","delivery":"Free delivery & Free 14-day returns","price":"$1,099.00","parsed_price":1099.0},{"query":"iphone","position":2,"link":"https://www.google.com/shopping/product/3628886803268507508?q=iphone&hl=en&gl=US&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gs_lcp=UvHSLA7Uz640JlchZYoULTOTy09hxrjXrbg1BddDeXJ1L8hKvAxhTGpJh681VIB&prds=eto:15912357296963554972_0,pid:11865528305208463674,rsk:PC_8971650804785857268&sa=X&ved=0ahUKEwjeu_vYub74AhWjj2oFHeQACRYQ8gII9BAoAA","image":"https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRWxIGEb1fJRjba94du551MI4bqKa7IVDrLx_2SUc-skisFAnpU2Zk3BdyhBxZtdvf2oOnAhdfuaV7JAgVTZhxQYHqFCxaNqgq3udmR9mnZM0H1cwdTMyhd&usqp=CAE","title":"Apple iPhone 13 - 128 GB - Green","options":"4.67,547","id":"11865528305208463674","source":"Best Buy","source_link":"https://www.google.com/url?url=https://www.bestbuy.com/site/apple-iphone-13-5g-128gb-green-verizon/6487362.p%3FskuId%3D6487362%26ref%3DNS%26loc%3D101&rct=j&q=&esrc=s&sa=U&ved=0ahUKEwjeu_vYub74AhWjj2oFHeQACRYQguUECP0Q&usg=AOvVaw3alRPH-ZQWxgpeQHBqycSg","delivery":"Free delivery by Jun 27 & Free 30-day returns","price":"4.6/5","parsed_price":4.6},{"query":"iphone","position":3,"link":"https://www.google.com/shopping/product/10710100573010676174?q=iphone&hl=en&gl=US&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gs_lcp=UvHSLA7Uz640JlchZYoULTOTy09hxrjXrbg1BddDeXJ1L8hKvAxhTGpJh681VIB&prds=eto:1516518942022937630_0,pid:13982584929019165962,rsk:PC_12721096405768421674&sa=X&ved=0ahUKEwjeu_vYub74AhWjj2oFHeQACRYQ8gIIiREoAA","image":"https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcQ3s_S0UyOCmOtBiIX9XGoN9YroGi0QCRbUJaQA3c2OkdtPHfZoCBIjQLj7nz4H8HKOD3ArTDggeDL_VFPVnW_Q6_x-O_iV86vwyhjq4iE&usqp=CAE","title":"Apple iPhone 13 Pro - 128 GB - Alpine Green","options":"4.67,001","id":"13982584929019165962","source":"T-Mobile","source_link":"https://www.google.com/url?url=https://www.t-mobile.com/cell-phone/apple-iphone-13-pro%3Fsku%3D194253118831&rct=j&q=&esrc=s&sa=U&ved=0ahUKEwjeu_vYub74AhWjj2oFHeQACRYQguUECJER&usg=AOvVaw39zC2xSjmvfIGfvQmaQKid","delivery":"Free delivery","price":"4.3/5","parsed_price":4.3}]]}, "google_shopping_reviews": {"id":"your-request-id","status":"Success","data":[[{"query":"7016166685587850095","product_name":"Apple iPhone 13 - 128 GB - Blue","rating":1,"title":"Came from XR, Not happy with the 13","body":"My last few iPhones have lasted me a long time, I bought a 13 after almost 4 years with my XR (iPhone 10). With a good amount of time between purchases I normally see a big difference/improvement in many areas upon getting a new iphone. Not this time. Camera is supposed to be much higher quality - I can't get it to focus without having to manually switch a setting and even then the XR photos would focus better and show more detail in the photo. It sounds much worse than the XR did - on a call the sound quality is noticeably poorer than my XR. The style of the phone is reminiscent of an iPhone 4, boxy and small, fit is not as comfortable in my hand width wise as the XR (normal size XR) was. I'm seeing no noticeable difference in operating speed and battery life which are supposed to be improved, does not appear to be any different for me over the XR. In all I wish I had taken my XR to a repair shop to confirm it was not able to be fixed instead of shelling out almost $900 for a new iPhone that in my opinion is a down grade from the XR three models prior! Note that NOT included in the box is the plug required to charge this phone, and no headphones. The lightening cord from a newer previous iPhone will work if your going from iPhone to iPhone but if you are new to an apple phone I guess Apple expects you to spend $900 for a phone and not even provide you with what you need to charge it! I've never been disappointed with an iPhone purchase before (iPhone4, iPhone5, iPhone6, iPhoneXR) but I am now. Apple drastically lowered the bar on the standards of an apple product with the iPhone 13 (and it appears on the iPhone 12 as well from the reviews I'm reading on them). I wish I hadn't been in a pinch causing me to make this purchase without researching first, mistake on my part.","source":"vzw.com","source_link":"http://verizonwireless.ugc.bazaarvoice.com/6543-en_us/dev16720001/review/215375582/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google","author":"JMPF","id":"3286903277271191692","date":"March 7, 2022","timestamp":1646611200},{"query":"7016166685587850095","product_name":"Apple iPhone 13 - 128 GB - Blue","rating":3,"title":"Headache for $1100 lol","body":"I\u2019m giving a three star review because the phone is still usable.

I purchased the iPhone 13 Pro Max.

I really wanted to say this is a straight up five star review but it's sadly not. In terms of build quality, they can have a billion stars. I think the build quality and the physical hardware is great and lives up to the expectation.

in terms of software, this feels like five steps backwards. When this phone came out with iOS 15 out the gate, I\u2019m telling you right now, I got a solid three days of battery life on Heavy usage - in between charges, which I\u2019ve never gotten out of anything I\u2019ve ever tried. The software interface itself was super smooth and almost heavenly. The buttery smooth 120 Hz refresh rate is probably one of my favorite specs about this other than battery life.

Honestly, I massively regret forgetting to turn off automatic updates. Every update since iOS 15, my phone is a glitchy mess. Siri doesn\u2019t like responding most of the time, phone calls drop or no one can hear me and I can't hear them, Bluetooth doesn\u2019t like acknowledging any of my previously paired devices (i came from iPhone 11), even after removing them entirely and repairing them all over again. Screen share, airplay etc and whatever else doesn\u2019t like to cooperate often. This phone just doesn\u2019t feel like a smart phone anymore, after these last couple of software updates.

And I'm really mad that I don't get 3 days on a charge anymore. I get maybe 2 full days.

I really hope that future updates fix this and bring back the glorious feeling the very first version of iOS 15 gave.","source":"Google","source_link":"","author":"Tom Niz","id":"-3598031973281430307","date":"November 30, 2021","timestamp":1638230400},{"query":"7016166685587850095","product_name":"Apple iPhone 13 - 128 GB - Blue","rating":5,"title":"Amazing phone but\u2026","body":"Most Notable changes from iPhone 12 to iPhone 13:

-Thicker/Heavier: 174g, previously 164g
-A15 Chip: previously A14 Chip
-Battery: 3240 mAh, previously 2815 mAh
-Brightness: 800 nits, previously 625 nits
-Storage: 128/256/512GB, previously 64/128/256GB
-Cameras: New/bigger sensors allow for more light capture/detail, New Photographic Styles and Cinematic Video effects.

The camera notch at the top is also noticeably smaller on the iPhone 13.

Opinions so far:
This iPhone 13 seems very similar to the iPhone 12. After using it for a few days, I can't say that there is anything dramatically different about this version compared to the iPhone 12. It feels slightly heavier, the screen is a bit brighter, the cameras seem to do a slightly better job in low light situations (sometimes), and it can shoot Cinematic Video, although I've had mixed results with that feature. The new chip should be faster, and the bigger battery should last slightly longer; but I haven't really noticed much of a difference in either of those categories with my daily use so far.

I can't really see a compelling reason to upgrade from the iPhone 12 at the moment. If you are looking for a more noticeable upgrade, you might want to check out the Pro versions, as the iPhone 13 Pro and Pro Max have 120 Hz refresh rate screens that really stand out to me; and combined with the better cameras and extra GPU in the Pros, those might be worth the extra cost to you.","source":"Best Buy","source_link":"http://reviews.bestbuy.com/3545/6443178/review/274417300/redirect.htm?ctc_referralType=Shopping&ctc_referralDescription=Google","author":"AnhHo","id":"3504233510729422616","date":"January 9, 2022","timestamp":1641686400}]]}, "google_play_reviews": {"id":"your-request-id","status":"Success","data":[[{"author_title":"Isaac Bargamian","author_id":"117932306222696996314","author_image":"https://play-lh.googleusercontent.com/a/AATXAJzkP52tB-ljIK6axq4aLKNMOQiGM6C40kvaQd2Q=mo","review_text":"It's so buggy. I use my phone to take pictures and then would like to be able make posts from my phone without having to upload them to my computer, but the app just struggles so much for the most basic functions. Sometimes it doesn't save/deletes what I've posted. For the size of Facebook and the resources at its disposal, you'd think they'd have a functional app.","review_rating":1,"review_likes":254,"version":"324.0.0.48.120","review_timestamp":1625058524,"review_datetime_utc":"06/30/2021 13:08:44","owner_answer":null,"owner_answer_timestamp":null,"owner_answer_timestamp_datetime_utc":null},{"author_title":"Bree Zocaro","author_id":"113889750225711416824","author_image":"https://play-lh.googleusercontent.com/a-/AOh14GiU7Mey6KWirY2EV0Lmn0qHXA96AWDhbnNWM2Ni","review_text":"Considering I have been trying to log in for a week with no further progress, the fact this large corporation cannot even fix a few minor glitches like sending a code via text message. It's just a little ridiculous, not even an email to consult this issue privately, Just a bunch of generic emails I don't need that aren't helping.","review_rating":1,"review_likes":786,"version":"324.0.0.48.120","review_timestamp":1625123788,"review_datetime_utc":"07/01/2021 07:16:28","owner_answer":null,"owner_answer_timestamp":null,"owner_answer_timestamp_datetime_utc":null},{"author_title":"Dylan","author_id":"114890948499114358541","author_image":"https://play-lh.googleusercontent.com/a/AATXAJyJPkoL3gyIx3Fj5KJ2fvIhZCWNqw0lDl3zhQiu=mo","review_text":"This app might as well be called Virtual Pocket Billboard. Whenever I wanna just look at ads, and nothing posted by anyone that I actually follow, I crack open some Facebook. Facebook used to be a really great tool for a lot of purposes such as promoting your business, band, art, whatever - or private sales in buy/sell/trade groups. But, like anything good, it only stays good for a short while until they figure out that they can monetize every cog in its system, and put an ad on every pixel.","review_rating":1,"review_likes":192,"version":"324.0.0.48.120","review_timestamp":1625079208,"review_datetime_utc":"06/30/2021 18:53:28","owner_answer":null,"owner_answer_timestamp":null,"owner_answer_timestamp_datetime_utc":null}]]}, "booking_reviews": {"id":"your-request-id","status":"Success","data": [[{"query":"https://www.booking.com/hotel/pl/aparthotel.fr.html","review_title":"Merveilleux","review_liked_text":"Nous n\u2019avons pas pris le petit d\u00e9jeuner \rMais l\u2019\u00e9tablissement est g\u00e9nial","review_disliked_text":"La r\u00e9ception","review_owner_response":"","review_score":10,"author_title":"Laurence","author_country":"France","author_room":"Studio Sup\u00e9rieur de Luxe","author_type":"Couple","author_stay_period":"4 nuits","author_stay_date":"F\u00e9vrier\u00a02023","review_date":"Commentaire envoy\u00e9 le 1\u00a0mars\u00a02023","review_timestamp":null,"review_id":"6cc94c70a89be1a0"},{"query":"https://www.booking.com/hotel/pl/aparthotel.fr.html","review_title":"Appart-hotel pratique et confortable en plein centre","review_liked_text":"Emplacement parfait , chambre propre et originale, r\u00e9ception ouverte 24/24 et serviable","review_disliked_text":"Chambre un peu \u00e9troite","review_owner_response":"","review_score":80,"author_title":"Aurelie","author_country":"France","author_room":"Studio Sup\u00e9rieur","author_type":"Couple","author_stay_period":"2 nuits","author_stay_date":"Septembre\u00a02023","review_date":"Commentaire envoy\u00e9 le 26\u00a0octobre\u00a02023","review_timestamp":null,"review_id":"7f5209cc52c065b8"},{"query":"https://www.booking.com/hotel/pl/aparthotel.fr.html","review_title":"Belle exp\u00e9rience dans un pays que je ne connaissais pas\u2026","review_liked_text":"Grandeur de la chambre et proximit\u00e9 du centre-ville\u2026","review_disliked_text":"Salle de bain trop petite\u2026","review_owner_response":"","review_score":80,"author_title":"Patrice","author_country":"Suisse","author_room":"Studio Sup\u00e9rieur","author_type":"Groupe","author_stay_period":"3 nuits","author_stay_date":"Octobre\u00a02023","review_date":"Commentaire envoy\u00e9 le 20\u00a0octobre\u00a02023","review_timestamp":null,"review_id":"ee0d975c67758ec7"}]]}, "expedia_search": {"id":"your-request-id","status":"Success","data":[]}, "expedia_reviews": {"id":"your-request-id","status":"Success","data": []}, "g2_reviews": {"id":"your-request-id","status":"Success","data": []}, "walmart_reviews": {"id":"your-request-id","status":"Success","data": []}, "target_reviews": {"id":"your-request-id","status":"Success","data": []}, "appstore_reviews": {"id":"your-request-id","status":"Success","data": []}, "airbnb_reviews": {"id":"your-request-id","status":"Success","data": []}, "indeed_reviews": {"id":"your-request-id","status":"Success","data": []}, "glassdoor_reviews": {"id":"your-request-id","status":"Success","data": []}, "capterra_reviews": {"id":"your-request-id","status":"Success","data": [[{"query":"https://www.capterra.com/p/228041/Google-Maps-scraper/","completenessScore":1.25,"cons":"- not accurate (even if you test query using their \"check\" query window - records may vary from your original query- lack of budget limit for each query (you can spend all your money to query that will deliver not exact results as expected)","easeOfUseRating":0.8,"functionalityRating":0.8,"id":"4067365","overallRating":1.0,"profilePictureUrl":"https://cdn0.capterra-static.com/profile-images/linkedin/555577a4c9d426968fe25394130f6e93.jpeg","pros":"+ easy of use+ server side (turn off your PC , app will work overnight)+ Excel file as result+ well documented/howto/support+ very cheap (price per record)+ duplicate filter+ some data from social media/website fetcher+email/phone filter+ free tier","recommendationRating":0.7,"reviewerCompanySize":"A","reviewerFirstName":"Rafa\u00bf","reviewerIndustry":"11","reviewerJobTitle":"Owner","reviewerLastName":"Mr\u00f3z","timeUsedProduct":"LessThan2Years","title":"best app to fetch leads from google maps","valueForMoneyRating":0.8,"writtenOn":"2022-10-23T19:09:04Z"},{"query":"https://www.capterra.com/p/228041/Google-Maps-scraper/","completenessScore":1.24,"cons":"I think that the tool is mostly built for developers right now as it provides the raw data.\nWhile it gives you the information you are probably looking for, i would assume that by using big data, the company can uncover more features and suggestions to the users.","easeOfUseRating":1.0,"functionalityRating":1.0,"id":"3174384","overallRating":1.0,"profilePictureUrl":"https://cdn0.capterra-static.com/profile-images/linkedin/7b789a80e6f01f9c0b6437344f7e71ff.jpeg","pros":"Ease of use, presentation and GUI are very simple and close to the real product.\nThis is important as it relates to the already daily use of the users and saves time on learning and onboarding.","recommendationRating":0.8,"reviewerCompanySize":"I","reviewerFirstName":"Ziv","reviewerIndustry":"8","reviewerJobTitle":"product manager","reviewerLastName":"Ginsberg","timeUsedProduct":"FreeTrial","title":"Great features for your needs","valueForMoneyRating":null,"writtenOn":"2021-10-28T18:47:56Z"},{"query":"https://www.capterra.com/p/228041/Google-Maps-scraper/","completenessScore":1.23,"cons":"I wish they were better at giving me an accurate estimate of how much each task is going to cost. I've found their tasks sometimes cost way less than their estimate, and there's probably been a few times where I would've gone through with paying for a task if their estimate didn't scare me off. Might be an impossible problem to fix though, can't really blame them.","easeOfUseRating":1.0,"functionalityRating":1.0,"id":"6102201","overallRating":1.0,"profilePictureUrl":null,"pros":"If you gave me $100 to start a business and only let me pick 1 tool to use, I would use Outscraper. I would find a service to provide to small businesses (probably building websites or local SEO), pick a niche (websites for dentists), find all of those leads for super cheap (much cheaper with Outscraper than other tools), and start emailing them asking if I could build them a website. So if Mr. Beast ever decides to do the 1 tool, $100 business challenge for a video, I'm picking Outscraper.","recommendationRating":1.0,"reviewerCompanySize":"A","reviewerFirstName":"Caleb","reviewerIndustry":"34","reviewerJobTitle":"Director of Operations","reviewerLastName":"Dueck","timeUsedProduct":"LessThan6Months","title":"The Google Maps Scraper is the best lead finder tool I've ever used.","valueForMoneyRating":1.0,"writtenOn":"2023-12-26T19:18:44Z"}]]}, "yelp_reviews": {"id":"your-request-id","status":"Success","data":[[{"query":"eggcellent-waffles-san-francisco","business_name":"Eggcellent Waffles","review_rating":5,"review_text":"This place is awesome!!

You are basically allowed to craft your dream sandwich. The customization is crazy and the portions are so satisfying. I would definitely recommend the savory options. I got a everything waffle with roast beef, ham, and horseradish. What a dream. I will be back.","review_photos":[],"review_tags":[],"owner_replies":[],"review_id":"mMzh-4D_-jNG1zzWGo5SYQ"},{"query":"eggcellent-waffles-san-francisco","business_name":"Eggcellent Waffles","review_rating":4,"review_text":"Honestly, I went to this place because of the silly name. It was a nice surprise. They have a wide variety of fillings to choose from sweet to savory, which is very nice. I've ordered the All Day waffle, which has sausage, avocado, cheese. What an interesting combination, well served and very tasty indeed. The pumpkin spice chai was also very good.

Nothing out of this world but a good experience no doubt.","review_photos":[],"review_tags":[],"owner_replies":[],"review_id":"KKshwKeYC8nxzkOtprq1Mw"},{"query":"eggcellent-waffles-san-francisco","business_name":"Eggcellent Waffles","review_rating":3,"review_text":"First time here. I am really excited by the idea of a waffle as the bread to a sandwich. My desire was for a savory breakfast to go. Nothing really struck me as that so I ordered the All Day sandwich. Pork, avacdo, cheese: great. Ranch dressing, yuck!
Great portion and there location is just down from the top of Knob Hill. (Nice park to sit in while eating.)
I see coming back again for a sweet waffle and there are several waffle flavors I'd like to try. However for the savory selections, I will be more selective. Maybe even building my own sandwich, which is an option.","review_photos":["https://s3-media0.fl.yelpcdn.com/bphoto/LGs0xZDWYS7sWlNV21r66g/300s.jpg"],"review_tags":["1 photo","1 check-in"],"owner_replies":[],"review_id":"xpQACYnoK7WmRSiR-6ObEw"}]]}, "yelp_data": {"id":"your-request-id","status":"Success","data":[[{"query":"https://www.yelp.com/search?find_desc=Restaurants&find_loc=San+Francisco%2C+CA","biz_id":"HHtpR0RslupSQ99GIIwW5A","name":"Marufuku Ramen","price_range":"$$","rating":4.4,"reviews":4109,"categories":["Ramen"],"formatted_dddress":"","neighborhoods":["Lower Pacific Heights"],"phone":"(415) 872-9786","business_url":"https://www.yelp.com/biz/marufuku-ramen-san-francisco-5?osq=Restaurants","services":["Outdoor seating","Delivery","Takeout"],"photo":"https://s3-media0.fl.yelpcdn.com/bphoto/ouK2VmW0SrI70jsJpTxJhw/348s.jpg","tags":["Waitlist is closed"],"snippet":"Long long overdue review, but I loved this place. The line was literally booty, so me and my friends went half an hour before opening, and sat by a nearby\u2026"},{"query":"https://www.yelp.com/search?find_desc=Restaurants&find_loc=San+Francisco%2C+CA","biz_id":"8VurRDEj1RpimenhgTmyFQ","name":"KAIY\u014c Rooftop","price_range":"","rating":3.8,"reviews":334,"categories":["Peruvian","Cocktail Bars","Sushi Bars"],"formatted_dddress":"","neighborhoods":["South Beach"],"phone":"","business_url":"https://www.yelp.com/biz/kaiy%C5%8D-rooftop-san-francisco-5?osq=Restaurants","services":["Outdoor seating","Delivery","Takeout"],"photo":"https://s3-media0.fl.yelpcdn.com/bphoto/IpnkGDpsm94wGzTAdFekPg/348s.jpg","tags":[],"snippet":null},{"query":"https://www.yelp.com/search?find_desc=Restaurants&find_loc=San+Francisco%2C+CA","biz_id":"J7_-faNq_Ag9qTOlDn81Pw","name":"Starbelly","price_range":"$$","rating":3.8,"reviews":2112,"categories":["Comfort Food","Cocktail Bars","Wine Bars"],"formatted_dddress":"","neighborhoods":["Castro"],"phone":"(415) 252-7500","business_url":"https://www.yelp.com/biz/starbelly-san-francisco?osq=Restaurants","services":["Outdoor seating","Delivery","Takeout"],"photo":"https://s3-media0.fl.yelpcdn.com/bphoto/G1SweY3VbKx_BqAws9RytA/348s.jpg","tags":["Live wait time: 0 mins"],"snippet":"Starbelly has been one of my go to comfort restaurants since I moved to this city. The menu is always fresh and new but the atmosphere and service always makes\u2026"}]]}, "yahoo_data": {}, "booking_search": {"id":"your-request-id","status":"Success","data":[]}, "hotels_search": {"id":"your-request-id","status":"Success","data":[]}, "indeed_search": {"id":"your-request-id","status":"Success","data":[[{"query":"https://www.indeed.com/jobs?q=&l=Fremont+Canyon%2C+CA","title":"Secretary I","normTitle":"Secretary","displayTitle":"Secretary I","viewJobLink":"https://indeed.com/viewjob?jk=d2500d00422b0da2&from=vjs&tk=1hto999c4kc0m85e&viewtype=embedded&xkcb=SoCk67M3B4aq6OTWi50BbzkdCdPP&continueUrl=%2Fjobs%3Fq%3D%26l%3DFremont%2BCanyon%252C%2BCA","company":"County of Orange","jobLocationState":"CA","jobLocationCity":"","formattedLocation":"Orange County, CA","remoteLocation":false,"createDate":1714103190000,"pubDate":1714021200000,"showJobType":false,"salarySnippet":{"currency":"USD","salaryTextFormatted":false,"source":"EXTRACTION","text":"$48,110.40 - $63,086.40 a year"},"snippet":"Screens and answers telephone calls and correspondences.\nOperates multiple telephone lines, computers and applicable peripheral equipment."},{"query":"https://www.indeed.com/jobs?q=&l=Fremont+Canyon%2C+CA","title":"Public Health Investigator Trainee","normTitle":"Public Health Nurse","displayTitle":"Public Health Investigator Trainee","viewJobLink":"https://indeed.com/viewjob?jk=086181c388b409a4&from=vjs&tk=1hto999c4kc0m85e&viewtype=embedded&xkcb=SoAQ67M3B4aq6OTWi50AbzkdCdPP&continueUrl=%2Fjobs%3Fq%3D%26l%3DFremont%2BCanyon%252C%2BCA","company":"County of Orange","jobLocationState":"CA","jobLocationCity":"","formattedLocation":"Orange County, CA","remoteLocation":false,"createDate":1715226363000,"pubDate":1715144400000,"showJobType":false,"salarySnippet":{"currency":"USD","salaryTextFormatted":false,"source":"EXTRACTION","text":"$48,110.40 - $64,771.20 a year"},"snippet":"Exercising appropriate judgment in answering questions and releasing information; analyzing and projecting consequences of decisions and/or recommendations."},{"query":"https://www.indeed.com/jobs?q=&l=Fremont+Canyon%2C+CA","title":"Administrative Assistant II - Events","normTitle":"Administrative Assistant","displayTitle":"Administrative Assistant II - Events","viewJobLink":"https://indeed.com/viewjob?jk=40f97edb490c4d00&from=vjs&tk=1hto999c4kc0m85e&viewtype=embedded&xkcb=SoCe67M3B4aq6OTWi50HbzkdCdPP&continueUrl=%2Fjobs%3Fq%3D%26l%3DFremont%2BCanyon%252C%2BCA","company":"In-N-Out","jobLocationState":"CA","jobLocationCity":"Irvine","formattedLocation":"Irvine, CA","remoteLocation":false,"createDate":1713557916000,"pubDate":1713502800000,"showJobType":false,"salarySnippet":{"currency":"USD","salaryTextFormatted":false,"source":"EXTRACTION","text":"$25.80 - $31.00 an hour"},"snippet":"Perform clerical functions such as preparing correspondence, receiving visitors, arranging conference calls and scheduling meetings, including department-wide\u2026"}]]}, "tripadvisor_search": {"id":"your-request-id","status":"Success","data":[{}]}, "reddit_comments": {"id":"your-request-id","status":"Success","data": []}, "yellowpages": {"id":"your-request-id","status":"Success","data":[[{"query":"restaurants","name":"Todaro Brothers","categories":["Restaurants","Italian Restaurants","Caterers"],"position":1,"years_in_business":null,"years_with_yp":null,"amenities":["Wheelchair accessible","Serves alcohol","Takes reservations"],"phone":"+1 212 532-0633","street":"555 2nd Ave","locality":"New York, NY 10016","site":"http://www.todarobros.com","snippet":"","thumbnail":"https://i3.ypcdn.com/ypu/images/default-thumbnails/thumbnail-3.svg?83117e0","range":"$$","business_link":"https://www.yellowpages.com/new-york-ny/mip/todaro-brothers-5642814?lid=1001105931107"},{"query":"restaurants","name":"Seven's Turkish Grill","categories":["Restaurants","Mediterranean Restaurants","Caterers"],"position":2,"years_in_business":null,"years_with_yp":null,"amenities":["Wheelchair accessible","Good for groups","Serves alcohol","Takes reservations"],"phone":"+1 212 724-4700","street":"158 W 72nd St","locality":"New York, NY 10023","site":"","snippet":"","thumbnail":"https://i4.ypcdn.com/blob/f430c3b1c5894703d31cb998e9342c3c58c091ab_130x130_crop.jpg?83117e0\n","range":"$$","business_link":"https://www.yellowpages.com/new-york-ny/mip/sevens-turkish-grill-460080517?lid=1000439722148"},{"query":"restaurants","name":"Mr. K's","categories":["Restaurants","Chinese Restaurants","Banquet Halls & Reception Facilities"],"position":3,"years_in_business":null,"years_with_yp":null,"amenities":[],"phone":"+1 212 583-1668","street":"570 Lexington Ave","locality":"New York, NY 10022","site":"http://www.mrksny.com","snippet":"","thumbnail":"https://i4.ypcdn.com/blob/c34e2901edfb966b565d36f5d8199a1b8b1a656f_130x130_crop.jpg?83117e0\n","range":"$$$","business_link":"https://www.yellowpages.com/new-york-ny/mip/mr-ks-407372?lid=1001117669298"}]]}, "yelp_biz_data": {"id":"your-request-id","status":"Success","data":[{"query":"eggcellent-waffles-san-francisco","biz_id":"ZTb_PX4IY6BdJrrQuTW0cw","name":"Eggcellent Waffles","business_url":"https://www.yelp.com/biz/eggcellent-waffles-san-francisco","closed":true,"reviews":31,"rating":4.6,"image":"https://s3-media0.fl.yelpcdn.com/bphoto/zWnDM0urkGpUDp2PNshiEA/l.jpg","phone":"(415) 678-5584","price_range":"Under $10","country":"US","state":"CA","city":"San Francisco","postal_code":"94108"}]}, "trustpilot_data": {"id":"your-request-id","status":"Success","data":[{"query":"outscraper.com","name":"Outscraper","rating":4,"reviews":16,"site":"http://outscraper.com","profile_image":"//s3-eu-west-1.amazonaws.com/tpd/logos/61c9aa394dd15d881199ed1a/0x0.png","page_url":null,"claimed":true,"closed":false,"temporarily_closed":false,"categories":["Database Management Company"],"email":"service@outscraper.com","phone":"","address":"Delaware state","city":"Middletown","country":"US","zip_code":"19709"}]}, "trustpilot_reviews": {"id":"your-request-id","status":"Success","data":[[{"query":"outscraper.com","total_reviews":16,"review_rating":5,"review_title":"Extremely easy to use API and very well documented","review_text":"Extremely easy to use API and very well documented - I've been using Outscraper for Google My Business review scraping to display reviews on our customers websites for the past two years with no issues whatsoever. Hope Facebook Page and Trustpilot reviews are added so that I can have everything within one place!","review_likes":0,"review_date":1675562103,"review_id":"63def0579b64b1bdaf4d4895","author_title":"James Morton","author_id":"570fd83f0000ff000a17730a","author_reviews_number":7,"author_reviews_number_same_domain":1,"author_country_code":"GB"},{"query":"outscraper.com","total_reviews":16,"review_rating":5,"review_title":"Powerful tool","review_text":"Powerful tool, and a very responsive team. If used properly it produces excellent results. I have been using this service for 2 weeks since then their team has responded to all of my questions within 24 hours or faster.","review_likes":0,"review_date":1674242416,"review_id":"63cacd504b01fb3f5488166f","author_title":"John Kofax","author_id":"63cacc929e3a180012b87a70","author_reviews_number":1,"author_reviews_number_same_domain":1,"author_country_code":"US"}]]}, "tripadvisor_reviews": {"id":"your-request-id","status":"Success","data":[[{"query":"https://www.tripadvisor.com/Restaurant_Review-g187147-d12947099-Reviews-Mayfair_Garden-Paris_Ile_de_France.html","review_link":"https://www.tripadvisor.com/ShowUserReviews-g187147-d12947099-r945962867-Mayfair_Garden-Paris_Ile_de_France.html","review_date":"2024-04-09","author_title":"BertysMum","review_rating":5,"review_title":"Fantastic food, great location, attentive staff","review_text":"We found Mayfair Garden on the last day of our trip to Paris. It was close to our hotel and the Eiffel Tower and we had wanted to see the Tower lit up at night so picked Mayfair Garden as it had good reviews and the location worked for us. \n\nWe are so glad we chose it. It was the best meal that we had during our trip to Paris. We booked a table via their online booking system, the restaurant was very busy that evening so it's probably best to book. We got confirmation via text and email. The staff were very welcoming when we arrived and very attentive throughout our meal. \n\nWe chose the taster menu and were very pleased with each course. The Pink kKachori, Chicken 65 and the Mayfair vanilla dessert were my favourites. They were all delicious and not like anything I have ever tasted before. I would absolutely recommend them. Also the garlic naan was exceptional. It was very light, not doughy like naan that I have had before and it was well flavoured.\n\nWe will visit Paris again in the future and the Mayfair Garden is the one restaurant that I will definitely visit again. \n\n100% recommend....I wish they had a restaurant in the UK so I could visit again sooner!!","review_media":[],"owner_title":"","owner_response":""},{"query":"https://www.tripadvisor.com/Restaurant_Review-g187147-d12947099-Reviews-Mayfair_Garden-Paris_Ile_de_France.html","review_link":"https://www.tripadvisor.com/ShowUserReviews-g187147-d12947099-r934711578-Mayfair_Garden-Paris_Ile_de_France.html","review_date":"2024-01-19","author_title":"430brankac","review_rating":5,"review_title":"Great experience with indian food","review_text":"Great food and very helpful staff.\n\nWe were very well received and served, even though we didn't have a reservation.\nThe restaurant has nice dishes and we liked the wine selection.\nWe will visit this restaurant again.","review_media":[],"owner_title":"","owner_response":""},{"query":"https://www.tripadvisor.com/Restaurant_Review-g187147-d12947099-Reviews-Mayfair_Garden-Paris_Ile_de_France.html","review_link":"https://www.tripadvisor.com/ShowUserReviews-g187147-d12947099-r920290826-Mayfair_Garden-Paris_Ile_de_France.html","review_date":"2023-10-08","author_title":"Ranilsg","review_rating":5,"review_title":"Top class south Asian cuisine in Paris","review_text":"This is the best South Asian cuisine I have tasted to-date in Paris/France. Hospitality at its best with the staff being so courteous and efficient. The overall experience was superb;it's an all-star restaurant.","review_media":[],"owner_title":"","owner_response":""}]]}, "amazon_products": {"id":"your-request-id","status":"Success","data":[[{"short_url":"https://www.amazon.com/Lacoste-Womens-Stainless-Leather-Calfskin/dp/B00G3XWLR8","asin":"B00G3XWLR8","name":"Lacoste Women's 12.12 Stainless Steel Quartz Watch with Leather Calfskin Strap, Taupe, 16 (Model: 2001150)","rating":null,"reviews":null,"answered_questions":null,"fast_track_message":null,"about":"ON TIME, IN STYLE: Once upon a time there was a polo shirt that made history now it has inspired a ladies timepiece to follow in its footsteps. The Lacoste.12.12 Lady is the epitome of sporty chic and comfort, with thoughtful dashes of detail. Game, set and match for style., QUALITY MATERIALS: Women's 36 mm pale rose gold ion-plated stainless steel case with a taupe leather strap featuring a carnation gold dial., QUARTZ MULTIFUNCTION: It\u2019s a battery-powered watch that sends energy through a quartz crystal. Is typically built into three separate dials for the day of the week, date of the month and 24-hour time., DURABLE MINERAL CRYSTAL: Made from glass and protects watch from scratches., 2 YEAR WARRANTY: Lacoste offers a 2-year limited warranty against defects in materials and workmanship that prevent the watch from functioning properly under normal use. Only purchases from an authorized retailer are covered by the manufacturer\u2019s warranty.","description":"The Lacoste legend was born in 1933, when Rene Lacoste revolutionized men's fashion replacing the classical woven fabric, long-sleeved and starched shirts on the courts, by what has now become the classic LACOSTE polo shirt. More than 75 years after its creation, LACOSTE has become a lifestyle brand which allies elegance and comfort. The LACOSTE art of living expresses itself today through a large collection of apparel for women, men and children, footwear, fragrances, leather goods, eyewear, watches, belts, home textiles, and fashion jewelry. LACOSTE founds its success on the essential values of authenticity, performance, and elegance. The crocodile incarnates today the elegance of the champion, Rene Lacoste, as well as of his wife Simone Lacoste and their daughter Catherine Lacoste, both also champions, in everyday life as on the tennis courts and golf courses. The Crocodile's origins The true story of the \"Crocodile\" begins in 1923 after a bet that Rene Lacoste had with the Captain of the French Davis Cup Team, Allan H. Muhr, who promised him an alligator suitcase if he won an important game for the team. This episode was reported in an article in the Boston Evening Transcript, where his nickname of the Crocodile came to life for the first time. The American public grew fond of this nickname which highlighted the tenacity he displayed on the tennis courts, never giving up his prey. His friend Robert George drew him a crocodile which was embroidered on the blazer he wore on the courts. The Legend was born.","categories":["Clothing, Shoes & Jewelry","Women","Watches","Wrist Watches"],"store_title":"Lacoste Store","store_url":"https://www.amazon.com/stores/Lacoste/page/C85490CB-0E64-4F8B-89A8-217111AFF6FE?ref_=ast_bln","price":"$175.00","availability":"In stock soon. Order it now.","strike_price":null,"price_saving":null,"shipping":"","merchant_info":"","bage":"","currency":null,"image_1":"https://m.media-amazon.com/images/I/314jzz9RfsL.jpg","image_2":"https://m.media-amazon.com/images/I/31he4kecs0L.jpg","image_3":"https://m.media-amazon.com/images/I/31FgebhbXEL.jpg","image_4":"https://m.media-amazon.com/images/I/41IYiTJyLIL.jpg","image_5":"https://m.media-amazon.com/images/I/41gZMv+FwoL.jpg","overview":null,"details":{"details.brand_seller_or_collection_name":"Lacoste","details.model_number":"2001150","details.part_number":"2001150","details.item_shape":"Round","details.dial_window_material_type":"Mineral","details.display_type":"Analog","details.clasp":"Tang Buckle","details.case_material":"Stainless Steel","details.case_diameter":"36 millimeters","details.case_thickness":"9.75 millimeters","details.band_material":"Leather","details.band_size":"Womens Standard","details.band_width":"16 millimeters","details.band_color":"Brown","details.dial_color":"Carnation Gold","details.bezel_material":"Stainless Steel","details.bezel_function":"Stationary","details.calendar":"Day-Date","details.movement":"Quartz","details.water_resistant_depth":"50 Meters","details.warranty":"Manufacturer\u2019s warranty can be requested from customer service. to make a request to customer service.","details.package_dimensions\n\u200f\n\n\u200e":"3.58 x 3.46 x 3.23 inches; 3.84 Ounces","details.item_model_number\n\u200f\n\n\u200e":"2001150","details.department\n\u200f\n\n\u200e":"Womens","details.date_first_available\n\u200f\n\n\u200e":"January 13, 2021","details.manufacturer\n\u200f\n\n\u200e":"Lacoste","details.asin\n\u200f\n\n\u200e":"B00G3XWLR8","details.country_of_origin\n\u200f\n\n\u200e":"China"}}]]}, "amazon_reviews": {"id":"your-request-id","status":"Success","data":[[{"query":"https://www.amazon.com/dp/1612680194","id":"R2VYT9ETWPTAWU","product_asin":"1612680194","title":"Everything","body":"I read this book about 11 years ago at 27 years old , had no money, I followed the advice in this book and now have 15 rental properties paid off free and clear, my assets more than cover all my expenses. I just bought this book again, I'm in the middle of reading it again now 11 years later and can't put it down. I hate reading btw. I plan on reading this book at least three more times over the next 20 years so I can keep all info fresh in my mind. People always ask me about success. I tell them to read this book...whats crazy is that they don't read it. You can lead a horse to water but can't make it drink. The book changed my life and it will change yours. Do you want change or do you just want to talk and think about change? There is a big difference , do it.","rating":5.0,"rating_text":"5.0 out of 5 stars","helpful":"1,331 people found this helpful","comments":null,"date":"Reviewed in the United States on March 17, 2018","bage":"Verified Purchase","official_comment_banner":"","url":"https://www.amazon.com/gp/customer-reviews/R2VYT9ETWPTAWU/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=1612680194","img_url":null,"variation":"","total_reviews":65459,"overall_rating":4.7,"author_title":"Ilive4him24","author_descriptor":"","author_url":"https://www.amazon.com/gp/profile/amzn1.account.AGQCR5JZP3V6Y743KX3UYJBRRVOA/ref=cm_cr_arp_d_gw_btm?ie=UTF8","author_profile_img":"https://images-na.ssl-images-amazon.com/images/S/amazon-avatars/default._CR0,0,1024,1024_SX48_.png","product_url":"https://www.amazon.com/dp/1612680194"},{"query":"https://www.amazon.com/dp/1612680194","id":"R1T9953QMMGUEX","product_asin":"1612680194","title":"Make sure you Select the Book Size","body":"I owned this book in the past and wanted to reorder it to read it again. Instead of getting the book I expected, I received a tiny, hand sized book, with print that is too small and that is, frankly, hard to open all the way in order to read the words near the binder. So the book is utterly useless. With all the complaints about this tiny book, I'm not sure why that is the book that automatically comes up when you search for the book. Instead, the normal sized book should be the default, and then people can select the pocket sized book if they want. So I would say that the content of the book is excellent. DO purchase the book; however, BE SURE TO SELECT THE LARGER, PAPERBACK VERSION if that's what you want (sorry for the all caps, just want to make sure people see that part).","rating":1.0,"rating_text":"1.0 out of 5 stars","helpful":"851 people found this helpful","comments":null,"date":"Reviewed in the United States on January 23, 2018","bage":"Verified Purchase","official_comment_banner":"","url":"https://www.amazon.com/gp/customer-reviews/R1T9953QMMGUEX/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=1612680194","img_url":null,"variation":"","total_reviews":65459,"overall_rating":4.7,"author_title":"judysardenspeaker","author_descriptor":"","author_url":"https://www.amazon.com/gp/profile/amzn1.account.AHBNQFY6SXYTRVWW7RUKDYY4RBBA/ref=cm_cr_arp_d_gw_btm?ie=UTF8","author_profile_img":"https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png","product_url":"https://www.amazon.com/dp/1612680194"},{"query":"https://www.amazon.com/dp/1612680194","id":"RIGBUZ8E2S6UT","product_asin":"1612680194","title":"A great foundation book for beginning to improve your financial intelligence","body":"This is an enhanced reprint of the original, with additional study questions/ discussion and review added at the end of every chapter. I bought the original about 18 years ago and it changed my families destiny for the better. I am glad the reprint came out as it prompted me to reread it and deepen my understanding. Some people complain that this book does not give a step by step process for change. I would counter that one size shoe does not fit all feet. There are many individual paths to wealth, and Kiyosaki sets the guiding stars to navigate by, but you have to walk your own individual road. Some key concepts of this book are: 1) Assets put money in your pocket even when you are on vacation. Liabilities take money out of your pocket, therefore your house is a liability [unless you rent out rooms and the garage as one person I know did while rebuilding his asset base]. 2) Wealthy people buy assets first, and then let their assets buy their luxuries from the surplus cash flow. 3) Wealthy people continuously increase their assets by reinvesting their surplus cash flow in more assets. 4) There are 3 primary asset classes: Real Estate, Businesses, and Paper assets (stocks bonds notes, etc) 5) Cash Flow is more important than Net Worth. Net Worth is similar to potential energy, to use it you have to spend it, then it is gone. Cash Flow is like power from a hydroelectric dam, constantly replenished. The rich don't work for money, they work for assets. The tax laws are fair from the standpoint that the laws that the rich spent billions of dollars to have modified and interpreted apply to everyone who learns how to use them. A great foundation book for beginning to improve your financial intelligence so that you don't work 4 or more month's of every year for the Tax man, more months for the banks that hold your mortgage and credit cards, and whatever is left making the company you work for wealthy. Good luck on your journey to being Rich, poor, or middle class.","rating":4.0,"rating_text":"4.0 out of 5 stars","helpful":"1,186 people found this helpful","comments":null,"date":"Reviewed in the United States on June 19, 2017","bage":"Verified Purchase","official_comment_banner":"","url":"https://www.amazon.com/gp/customer-reviews/RIGBUZ8E2S6UT/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=1612680194","img_url":null,"variation":"","total_reviews":65459,"overall_rating":4.7,"author_title":"Eugene C.","author_descriptor":"","author_url":"https://www.amazon.com/gp/profile/amzn1.account.AGUEMAJSJVAUZR2OUSFBBNJM3KQQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8","author_profile_img":"https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif","product_url":"https://www.amazon.com/dp/1612680194"}]]}, "google_maps_directions": {"id":"your-request-id","status":"Success","data":[[{"road":"I-94 W","distance(meters)":156550,"distance_label":"97.3 miles","duration(minutes)":100.0,"duration_min(minutes)":90.0,"duration_max(minutes)":120.0,"origin_coordinates":"41.513124399999995, -87.92831819999999","road_distance_timing(meters:seconds)":{"0":0,"30":10,"94":47,"111":49,"156325":5885,"156376":5891,"156461":5898,"156552":5905},"origin":"Lincoln-Way Central High School, Southwest Suburbs, 1801 E Lincoln Hwy, New Lenox, IL 60451","destination":"18th St and 19th Ave, Kenosha, WI 53140","destination_coordinates":"42.624320999999995, -87.83267","query_origin":"Lincoln Way ","query_destination":"19th Ave ","timestamp":1598288400,"datetime_utc":"08/24/2020 17:00:00"},{"road":"I-355 N","distance(meters)":183183,"distance_label":"114 miles","duration(minutes)":150.0,"duration_min(minutes)":130.0,"duration_max(minutes)":200.0,"origin_coordinates":"41.513124399999995, -87.92831819999999","road_distance_timing(meters:seconds)":{"0":0,"30":10,"94":47,"111":48,"182961":8972,"183015":8978,"183103":8985,"183187":8991},"origin":"Lincoln-Way Central High School, Southwest Suburbs, 1801 E Lincoln Hwy, New Lenox, IL 60451","destination":"18th St and 19th Ave, Kenosha, WI 53140","destination_coordinates":"42.624320999999995, -87.83267","query_origin":"Lincoln Way ","query_destination":"19th Ave ","timestamp":1598288400,"datetime_utc":"08/24/2020 17:00:00"}]]}, "google_search_autocomplete": {}, "domain_emails": {"id":"your-request-id","status":"Success","data":[{"query":"outscraper.com","domain":"outscraper.com","emails":[{"value":"service@outscraper.com","sources":[{"ref":"https://outscraper.com/","extracted_on":"2021-07-23T18:13:27.546000","updated_on":"2021-07-23T18:13:27.546000"},{"ref":"https://outscraper.com/pricing/","extracted_on":"2021-07-23T18:13:27.546000","updated_on":"2021-07-23T18:13:27.546000"},{"ref":"https://outscraper.com/yelp-scraper/","extracted_on":"2021-07-23T18:13:27.546000","updated_on":"2021-07-23T18:13:27.546000"},{"ref":"https://outscraper.com/careers/","extracted_on":"2021-07-23T18:13:27.546000","updated_on":"2021-07-23T18:13:27.546000"},{"ref":"https://outscraper.com/amazon-reviews-scraper/","extracted_on":"2021-07-23T18:13:27.546000","updated_on":"2021-07-23T18:13:27.546000"}]},{"value":"support@outscraper.com","sources":[{"ref":"https://outscraper.com/terms-of-service/","extracted_on":"2021-07-23T18:13:27.546000","updated_on":"2021-07-23T18:13:27.546000"},{"ref":"https://outscraper.com/privacy-policy/","extracted_on":"2021-07-23T18:13:27.546000","updated_on":"2021-07-23T18:13:27.546000"}]}],"socials":{"facebook":"https://www.facebook.com/outscraper/","github":"https://github.com/outscraper","linkedin":"https://www.linkedin.com/company/outscraper/","twitter":"https://twitter.com/outscraper","youtube":"https://www.youtube.com/channel/UCDYOuXSEenLpt5tKNq-0l9Q"},"site_data":{"generator":"WordPress 5.7.2","title":"Outscraper"}}]}, "contacts_n_leads": {"id":"your-request-id","status":"Success","data":[{"query":"outscraper.com","details":{"industry":["Custom Software & IT Services","Business Services"],"founded":"2018","name":"Outscraper","size":{"f":11,"t":50},"type":"Private","address":"Delaware state","city":"Middletown","employees":"<25","postal_code":"19709","state":"Texas","country":"US","sales":"< $5M"},"emails":[],"phones":[{"value":"12812368208","source":"https://www.facebook.com/outscraper/"}],"site_data":{"description":"Scrape Google Maps Places, Business Reviews, Photos, Play Market Reviews, and more. Get any public data from the internet by applying cutting-edge technologies.","generator":"All in One SEO Pro (AIOSEO) 4.7.0","title":"Outscraper - get any public data from the internet","has_fb_pixel":false,"has_google_tag":false,"keywords":"data extraction, web scraping, Google Maps, lead generation"},"socials":{"facebook":"http://www.facebook.com/outscraper","github":"https://github.com/outscraper","linkedin":"http://www.linkedin.com/company/outscraper","twitter":"http://www.twitter.com/outscraper","whatsapp":"https://wa.me/12812368208","youtube":"https://www.youtube.com/channel/UCDYOuXSEenLpt5tKNq-0l9Q","discord":"https://discord.gg/kcQzJW7rYr","crunchbase":"https://www.crunchbase.com/organization/outscraper"},"domain":"outscraper.com","contacts":[{"full_name":"Vlad Sima","emails":[{"value":"vlad.sima@outscraper.com","source":"linkedin"}],"title":"data alchemist","socials":{"linkedin":"simokhodsky"},"categories":["technical"]},{"full_name":"kseniia maiesh","emails":[{"value":"kseniia@outscraper.com","source":"smtp"}]},{"emails":[{"value":"vlad@outscraper.com","first_seen":"08/12/2025 23:10:06","last_seen":"08/13/2025 01:06:10","source":"smtp"}],"full_name":"vlad may"}]}]}, "facebook_pages": {"id":"your-request-id","status":"Success","data":[{"query":"outscraper","about":"At Outscraper, we believe that public data is for everybody, and we apply cutting-edge technologies to prove it.","email":"service@outscraper.com","followers":45,"likes":43,"name":"Outscraper","phone":"+1 281-236-8208","rating":5.0,"reviews":6,"site":"https://outscraper.com/","types":["App page","Website","Business Service"]}]}, "facebook_reviews": {"id":"your-request-id","status":"Success","data":[[{"query":"outscraper","page_url":"https://www.facebook.com/outscraper","page_name":"Outscraper","page_rating":"5","page_reviews_count":"9","author_link":"https://www.facebook.com/mark.kreischer","author_title":"Mark Kreischer","review_text":"BY FAR one of the best companies I have ever dealt with and I have been in this industry for 11 years now.. 1000% recommend. Dana is the BEST!!!!"},{"query":"outscraper","page_url":"https://www.facebook.com/outscraper","page_name":"Outscraper","page_rating":"5","page_reviews_count":"9","author_link":"","author_title":"","review_text":""},{"query":"outscraper","page_url":"https://www.facebook.com/outscraper","page_name":"Outscraper","page_rating":"5","page_reviews_count":"9","author_link":"https://www.facebook.com/kjetil.treffsikker","author_title":"Kjetil Treffsikker","review_text":"Had an awesome experience with customer support at Outscraper. They got their dev team to respond to my request in hours, something I never experience elsewhere. Also love their interface and product. Top notch!"}]]}, "emails_validator": {"id":"your-request-id","status":"Success","data":[{"query":"support@outscraper.com","status":"RECEIVING","status_details":"SMTP validated"}]}, "phones_enricher": {"id":"your-request-id","status":"Success","data":[{"query":"12812368208","carrier_name":"AERIAL COMMUNICATIONS","carrier_type":"mobile"}]}, "messaging": {"id":"your-request-id","status":"Success","data":[{"phone":"+12812368208","message":"Hello","status":"sent"}]}, "youtube_search": {"id":"your-request-id","status":"Success","data":[{"query":"cats","organic_results":[{"video_id":"N8siuNjyV7A","video_url":"https://www.youtube.com/watch?v=N8siuNjyV7A","video_title":"1 Hour Of Funniest Animals \ud83d\ude05 New Funny Cats and Dogs Videos \ud83d\ude38\ud83d\udc36 Part 14","video_thumbnail":"https://i.ytimg.com/vi/N8siuNjyV7A/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDjrkgH8B8y9Lw4ygPNe8OC-iNiag","video_length":"1:01:24","video_views":"21,564,254","video_short_description":"Welcome to Naughty Animals funny channel \u2665 You can enjoy best funny cats and dogs videos (\u2267\u25bd\u2266) Thanks for watching our\u00a0...","video_published":"1 month ago","channel_title":"Naughty Animals","channel_url":"https://www.youtube.com/@naughtyanimalstv","channel_thumbnail":"https://yt3.ggpht.com/EVQSeCZYlBrba-D6-RHiWOr3nPbGneftZCwWhz0lQyYiug7ff9-ZRjfYOhzgBs0Fbxs5D9hJwxY=s68-c-k-c0x00ffffff-no-rj"}],"estimated_results":"537091926"}]}, "youtube_channel": {"id":"your-request-id","status":"Success","data":[{"query":"outscraper","title":"Outscraper","description":"Solutions for accessing public information from the internet for lead generation, marketing, and data science.","channel_id":"UCDYOuXSEenLpt5tKNq-0l9Q","channel_url":"https://www.youtube.com/channel/UCDYOuXSEenLpt5tKNq-0l9Q","is_family_safe":true,"vanity_channel_url":"http://www.youtube.com/@outscraper","keywords":"Outscraper outscraper.com \"data scraping\" \"web scraping\" \"b2b lead generation\"","rss_url":"https://www.youtube.com/feeds/videos.xml?channel_id=UCDYOuXSEenLpt5tKNq-0l9Q","thumbnail":"https://yt3.googleusercontent.com/gWnPr_jKVFS5TV4vYlvlWOhjzaZrx_d8EPfgY_i_j4aVVyRBs_W09Y6fkFw_J7x57dcnNspo=s900-c-k-c0x00ffffff-no-rj","primary_links":[],"secondary_links":[],"videos_count":"48","videos_count_parsed":48,"subscribers_count":"849 subscribers","subscribers_count_parsed":849,"views_count":null,"views_count_parsed":null,"joined":null,"country":null}]}, "youtube_comments": {"id":"your-request-id","status":"Success","data":[[{"query":"ph5pHgklaZ0","id":"Ugz132zfBToXgljTfeN4AaABAg","published":"3 months ago","votes":"1","replies":1,"content":"That's really amazing!!","author_title":"Passivern","author_image":"https://yt3.ggpht.com/DE1ibHFAJTW-JiCmpNP03zWq-nzZkcCSqOYqvt-ETO44sAo2MHRbe8C9EaZxm55PU_ZkUPohRg=s176-c-k-c0x00ffffff-no-rj","author_chanel":"https://www.youtube.com/channel/UCayxkzRf0YtkrjClYNXKtkw","is_channel_owner":false},{"query":"ph5pHgklaZ0","id":"UgzewK4ls57SqX7bqzJ4AaABAg","published":"3 months ago","votes":"4","replies":2,"content":"you didnt show how the results are presented in the excel file. neither the information it provides.","author_title":"Raphael Marchetti","author_image":"https://yt3.ggpht.com/ytc/AMLnZu93TZ8gTV7tsAvzKvcXXCkdHaWbV-VDj_qV3ZAl8V0=s176-c-k-c0x00ffffff-no-rj","author_chanel":"https://www.youtube.com/channel/UCqf36ZDCtT0jgJCrFAZBPgQ","is_channel_owner":false},{"query":"ph5pHgklaZ0","id":"Ugyz1bWX3wU_o58RTbB4AaABAg","published":"3 months ago","votes":"1","replies":1,"content":"In Google my business for Canada and India location we are not the email.id.","author_title":"Ajay Kumar","author_image":"https://yt3.ggpht.com/ytc/AMLnZu9A9lbon4rJhz5Q3yqcikjjLL92u2Oik5AHACCP=s176-c-k-c0x00ffffff-no-rj","author_chanel":"https://www.youtube.com/channel/UCaiks6SS-3FyJOgC3N4WCGg","is_channel_owner":false},{"query":"ph5pHgklaZ0","id":"Ugx8lkieQlZhMuQnSYh4AaABAg","published":"3 months ago","votes":"1","replies":1,"content":"I can't work with this\nI was asked to put card details before anything...","author_title":"Mildin Cool","author_image":"https://yt3.ggpht.com/ytc/AMLnZu8yPgvo75LeYMYab3Fpn5FDQMVp8Pxb-UR5Sg4v=s176-c-k-c0x00ffffff-no-rj","author_chanel":"https://www.youtube.com/channel/UCNRrASwaMj6YRWsF3eL91Aw","is_channel_owner":false}]]}, "tiktok_comments": {}, "youtube_videos": {}, "youtube_transcripts": {}, "onlyfans_profiles": {"id":"your-request-id","status":"Success","data":[{"query":"aaroncarter","view":"f","avatar":"https://public.onlyfans.com/files/e/ea/ean/ean3xqrylsrtqrmpi0zvkk8aaqpvogiy1661985188/21637698/avatar.jpg","avatarThumbs":{"c50":"https://public.onlyfans.com/files/thumbs/c50/e/ea/ean/ean3xqrylsrtqrmpi0zvkk8aaqpvogiy1661985188/21637698/avatar.jpg","c144":"https://public.onlyfans.com/files/thumbs/c144/e/ea/ean/ean3xqrylsrtqrmpi0zvkk8aaqpvogiy1661985188/21637698/avatar.jpg"},"header":"https://public.onlyfans.com/files/8/8e/8ev/8evrknxdpf2wrcikkpajtn8htxvzcybz1661985189/21637698/header.jpg","headerSize":{"width":1536,"height":2048},"headerThumbs":{"w480":"https://public.onlyfans.com/files/thumbs/w480/8/8e/8ev/8evrknxdpf2wrcikkpajtn8htxvzcybz1661985189/21637698/header.jpg","w760":"https://public.onlyfans.com/files/thumbs/w760/8/8e/8ev/8evrknxdpf2wrcikkpajtn8htxvzcybz1661985189/21637698/header.jpg"},"id":21637698,"name":"Aaroncarter","username":"aaroncarter","canLookStory":false,"canCommentStory":false,"hasNotViewedStory":false,"isVerified":true,"canPayInternal":false,"hasScheduledStream":false,"hasStream":false,"hasStories":false,"tipsEnabled":false,"tipsTextEnabled":true,"tipsMin":5,"tipsMinInternal":1,"tipsMax":200,"canEarn":true,"canAddSubscriber":true,"subscribePrice":9,"subscriptionBundles":[{"id":6326813,"discount":25,"duration":3,"price":20.25,"canBuy":false}],"unprofitable":true,"isMuted":false,"isRestricted":false,"canRestrict":true,"subscribedBy":false,"subscribedByExpire":null,"subscribedByExpireDate":null,"subscribedByAutoprolong":null,"subscribedIsExpiredNow":null,"currentSubscribePrice":null,"subscribedOn":false,"subscribedOnExpiredNow":null,"subscribedOnDuration":null,"joinDate":"2020-02-17T00:00:00+00:00","isReferrerAllowed":true,"about":"OFFICIAL AARON CARTER ACCOUNT \u2714\ufe0f Exclusive Nsfw Content. - Just being myself!! Hiii yes it\u2019s me.","rawAbout":"OFFICIAL AARON CARTER ACCOUNT \u2714\ufe0f Exclusive Nsfw Content. - Just being myself!! Hiii yes it\u2019s me.","website":"https://Www.Onlyfans.com/houseofcarters","wishlist":null,"location":null,"postsCount":177,"archivedPostsCount":68,"privateArchivedPostsCount":0,"photosCount":146,"videosCount":16,"audiosCount":1,"mediasCount":163,"lastSeen":"2022-09-21T08:56:24+00:00","favoritesCount":25,"favoritedCount":69037,"showPostsInFeed":false,"canReceiveChatMessage":false,"isPerformer":true,"isRealPerformer":true,"isSpotifyConnected":false,"subscribersCount":null,"hasPinnedPosts":false,"hasLabels":true,"canChat":true,"callPrice":0,"isPrivateRestriction":true,"showSubscribersCount":false,"showMediaCount":true,"subscribedByData":null,"subscribedOnData":null,"canPromotion":true,"canCreatePromotion":true,"canCreateTrial":true,"isAdultContent":true,"canTrialSend":false,"hadEnoughLastPhotos":false,"hasLinks":false,"referalBonusSummForReferer":38661.96,"isFriend":false,"isBlocked":false,"canReport":false}]}, "google_places_by_domain": {"id":"your-request-id","status":"Success","data":[{}]}, "uber_eats": {}, "deliveroo": {}, "deliveroo_reviews": {}, "zoominfo": {}, "zoominfo_domains": {}, "domaininfo": {}, "crunchbase": {}, "crunchbase_search": {}, "feedbackcompany": {}, "feedbackcompany_reviews": {}, "willhaben": {}, "mobilede": {}, "immowelt": {}, "allegro": {}, "craigslist": {}, "1688_search": {}, "glassdoor_company_jobs": {}, "upwork_jobs": {}, "offerup": {}, "angi": {}, "feefo_reviews": {}, "thuisbezorgd_reviews": {}, "producthunt_profiles": {} } } }, "security": [{"ApiKeyAuth": []}], "paths": { "/google-maps-search" : { "get": { "summary": "Google Places", "description": "Returns places from Google Maps based on a given search query (or many queries).\n\nThe results from searches are the same as you would see by visiting a regular [Google Maps](https://www.google.com/maps/search/restaurants,+Manhattan,+New+York,+NY,+USA/) site. However, in most cases, it's important to use locations inside queries (e.g., `bars, NY, USA`) as the IP addresses of Outscraper's servers might be located in different countries.\n\nIn case no places were found by your search criteria, your search request will consume the usage of one place.\n\nThis endpoint is optimized for fast responses and can be used as a real-time API. Set the `limit` parameter to `10` to achieve the maximum response speed.", "tags": ["Google", "Businesses & POI"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_maps_query_v2"}, {"$ref": "#/components/schemas/parameters/maps_limit"}, {"$ref": "#/components/schemas/parameters/maps_drop_duplicates"}, {"$ref": "#/components/schemas/parameters/maps_total_limit"}, {"$ref": "#/components/schemas/parameters/coordinates_v2"}, { "in": "query", "name": "skipPlaces", "required": false, "description": "Skip first N places from a query search, where N should be multiple to 20 (e.g. 0, 20, ... 500). Used for pagination.", "schema": { "type": "integer", "default": 0 } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.google_maps_search('restaurants, Manhattan, NY, USA', limit=3)" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.google_maps_search('restaurants, Manhattan, NY, USA', limit: 20, language: 'en', region: 'us')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->google_maps_search(['restaurants, Manhattan, NY, USA'], $limit=3);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.googleMapsSearch(['restaurants, Manhattan, NY, USA'], limit=20, language='en', region='us').then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.GoogleMapsSearch(map[string]string {\n \"query\": \"restaurants, Manhattan, NY, USA\",\n \"limit\": \"20\",\n \"language\": \"en\",\n \"region\": \"us\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.googleMapsSearch(new HashMap() {{\n put(\"query\", \"bars ny usa\");\n put(\"limit\", 10);\n}});" } ] }, "post": { "summary": "Google Places (bigger payload capabilities)", "description": "Returns places from Google Maps based on a given search query (or many queries).\n\nThe results from searches are the same as you would see by visiting a regular [Google Maps](https://www.google.com/maps/search/restaurants,+Manhattan,+New+York,+NY,+USA/) site. However, in most cases, it's important to use locations inside queries (e.g., `bars, NY, USA`) as the IP addresses of Outscraper's servers might be located in different countries.\n\nIn case no places were found by your search criteria, your search request will consume the usage of one place.\n\nThis endpoint is optimized for fast responses and can be used as a real-time API. Set the `limit` parameter to `10` to achieve the maximum response speed.\n\nThe POST endpoint is identical to GET and made to support a bigger payload, such as when sending a large number of queries.", "tags": ["Google", "Businesses & POI"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_maps_query_v2"}, {"$ref": "#/components/schemas/parameters/maps_limit"}, {"$ref": "#/components/schemas/parameters/maps_drop_duplicates"}, {"$ref": "#/components/schemas/parameters/maps_total_limit"}, {"$ref": "#/components/schemas/parameters/coordinates_v2"}, { "in": "query", "name": "skipPlaces", "required": false, "description": "Skip first N places from a query search, where N should be multiple to 20 (e.g. 0, 20, ... 500). Used for pagination.", "schema": { "type": "integer", "default": 0 } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X POST https://api.outscraper.cloud/google-maps-search -d '{\"query\": [\"restaurants Manhattan NY USA\"], \"limit\": 3, \"async\": false}' -H \"Content-Type: application/json\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/maps/search" : { "get": { "summary": "Google Places (deprecated)", "description": "Returns places from Google Maps based on a given search query (or many queries).\n\nThe results from searches are the same as you would see by visiting a regular [Google Maps](https://www.google.com/maps/search/restaurants,+Manhattan,+New+York,+NY,+USA/) site. However, in most cases, it's recommended to use locations inside queries (e.g., `bars, NY, USA`) as the IP addresses of Outscraper's servers might be located in different countries.\n\nIn case no places were found by your search criteria, your search request will consume the usage of one place.", "tags": ["Google", "Businesses & POI"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_maps_query"}, {"$ref": "#/components/schemas/parameters/maps_limit"}, {"$ref": "#/components/schemas/parameters/maps_drop_duplicates"}, {"$ref": "#/components/schemas/parameters/maps_total_limit"}, {"$ref": "#/components/schemas/parameters/coordinates"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/maps/search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/maps/search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.google_maps_search_v1('restaurants, Manhattan, NY, USA', limit=3)" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->google_maps_search_v1(['restaurants, Manhattan, NY, USA'], $limit=3);" } ] } }, "/businesses" : { "post": { "summary": "List Business Records", "description": "Retrieve business records with optional enrichment data.\n\nThis endpoint provides access to millions of business listings with support for pagination and selective data enrichment. Choose which enrichments to include (contacts, emails, phone numbers, company insights, email verification, etc.) to optimize response size and cost.\n\nPerfect for building lead lists, market research, or populating your CRM with verified business data.", "tags": ["Businesses & POI", "Business Data API"], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "filters": {"$ref": "#/components/schemas/parameters/businesses_filters"}, "limit": { "type": "integer", "description": "Maximum number of business records to return.", "default": 10, "minimum": 1, "maximum": 1000 }, "cursor": { "type": "string", "description": "Cursor for pagination to retrieve the next set of results.", "nullable": true }, "query": { "type": "string", "description": "Natural language query to search for businesses (e.g., `restaurants in New York`). This is an alternative to using structured filters and can be used in combination with them. The API will attempt to parse the query and apply relevant filters based on the content.", "nullable": true }, "include_total": { "type": "boolean", "description": "Whether to include the total count of matching records in the response. This could increase response time.", "default": false }, "fields": { "type": "array", "description": "List of fields to include in the response. If not specified, all fields will be returned.", "items": { "type": "string" }, "example": ["name", "address", "website", "phone", "rating"] } }, "example": { "filters": { "country_code": "US", "states": ["NY"], "cities": ["New York", "Buffalo"], "types": ["restaurant", "cafe"], "has_website": true, "has_phone": true, "business_statuses": ["operational"] }, "limit": 10, "cursor": null, "include_total": false, "fields": ["name", "types", "address", "state", "postal_code", "country", "website", "phone", "rating", "reviews", "photo"] } } } } }, "responses": { "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [] } }, "/businesses/{business_id}" : { "get": { "summary": "Get Business Details", "description": "Retrieve detailed information for a specific business by `os_id`, `place_id`, or `google_id`, with optional enrichments.\n\nReturns a complete business profile including basic information plus any requested enrichment data such as contacts, emails, phone numbers, company insights, email verification, and more.\n\nIdeal for enriching existing records in your database or getting comprehensive data about a specific business.", "tags": ["Businesses & POI", "Business Data API"], "parameters": [ { "name": "business_id", "in": "path", "required": true, "description": "Business identifier (os_id, place_id, or google_id).", "schema": {"type": "string" }, "example": "0x808fbae5987442ef:0xa822d31a98c92c62" }, { "name": "fields", "in": "query", "description": "List of fields to include in the response.", "required": false, "schema": {"type": "string"} } ], "responses": { "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [] } }, "/google-places-by-domain" : { "get": { "summary": "Google Places by Domain", "description": "Allows finding places by domains.\n\nIn case no places were found by your criteria, your search request will consume the usage of one place.", "tags": ["Google", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Domains or websites (e.g., `dominopark.com`, `https://www.esbnyc.com/`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/items_per_query"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_places_by_domain"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-places-by-domain?query=dominopark.com&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-places-by-domain?query=dominopark.com\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-search-flights" : { "get": { "summary": "Google Search Flights", "description": "Allows scraping search results from Google Flights.", "tags": ["Google"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Each query is a list with the first item: origin - airport code, for example 'EWR', 'JFK', 'CMB' etc. Second item: destination - airport code, for example 'EWR', 'JFK', 'CMB' etc.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, { "in": "query", "name": "departure_date", "required": false, "description": "Departure date as a UNIX timestamp (e.g., '1756069200'). Defaults to current date.", "schema": { "type": "string" } }, { "in": "query", "name": "return_date", "required": false, "description": "Return date as a UNIX timestamp (e.g., '1757451600'). If missing, scraper uses only departure_date.", "schema": { "type": "string" } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": "The response contains the `status` of the request and `data`.", "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-flights?query=[['EWR','JFK']]&departure_date=1756069200&return_date=1757451600&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-flights?query=[['CMB','DXB']]\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-maps-directory" : { "get": { "summary": "Google Directory Places (beta)", "description": "Returns Google Maps places located in a parent place (mall, food court, etc.)", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_maps_query"}, { "in": "query", "name": "perQuery", "required": false, "description": "The parameter specifies the limit of places to get from one parent place (mall, food court, etc.).", "schema": { "type": "integer", "default": 100 } }, {"$ref": "#/components/schemas/parameters/coordinates"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": "The response contains the `status` of the request and `data`.", "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-directory?query=0x471ecd8244fdcebd:0xb85154ecc5453e10&perQuery=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-directory?query=0x471ecd8244fdcebd:0xb85154ecc5453e10&perQuery=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-maps-reviews" : { "get": { "summary": "Google Maps Reviews", "description": "Returns Google Maps reviews from places when using search queries (e.g., `restaurants, Manhattan, NY, USA`) or from a single place when using `Google IDs` or names (e.g., `NoMad Restaurant, NY, USA`, `0x886916e8bc273979:0x5141fcb11460b226`). In addition to the reviews, it returns places information.\n\nIn case no reviews were found by your search criteria, your search request will consume the usage of one review.\n\nThis endpoint is optimized for fast responses and can be used as a real-time API. Set the reviewsLimit parameter to 10 to achieve the maximum response speed.", "tags": ["Google", "Reviews & Comments"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_maps_query_v2"}, {"$ref": "#/components/schemas/parameters/maps_reviews_reviews_limit"}, {"$ref": "#/components/schemas/parameters/maps_reviews_query"}, {"$ref": "#/components/schemas/parameters/maps_reviews_limit"}, {"$ref": "#/components/schemas/parameters/maps_reviews_sort"}, {"$ref": "#/components/schemas/parameters/last_pagination_id"}, {"$ref": "#/components/schemas/parameters/maps_reviews_start"}, {"$ref": "#/components/schemas/parameters/maps_reviews_cutoff"}, {"$ref": "#/components/schemas/parameters/maps_reviews_cutoff_rating"}, {"$ref": "#/components/schemas/parameters/maps_reviews_cutoff_ignore_empty"}, { "in": "query", "name": "source", "required": false, "description": "The parameter specifies source filter. This commonly used for hotels where you can find reviews from other sources like Booking.com, Expedia, etc.", "schema": { "type": "string", "enum": [ "google" ], "default": null } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": "The response contains the `status` of the request and `data`. Data is an array where each element represents a place with its reviews.", "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-reviews?query=The%20NoMad%20Restaurant,%20NY,%20USA&reviewsLimit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-reviews?query=The%20NoMad%20Restaurant,%20NY,%20USA&reviewsLimit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.google_maps_reviews('The NoMad Restaurant, NY, USA', reviews_limit=3)" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.google_maps_reviews('The NoMad Restaurant, NY, USA', reviews_limit: 3)" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->google_maps_reviews(['The NoMad Restaurant, NY, USA'], $reviews_limit=3);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.googleMapsReviews(['The NoMad Restaurant, NY, USA'], reviewsLimit=3).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.GoogleMapsReviews(map[string]string {\n \"query\": \"The NoMad Restaurant, NY, USA\",\n \"reviewsLimit\": \"3\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.googleMapsReviews(new HashMap() {{\n put(\"query\", \"The NoMad Restaurant, NY, USA\");\n put(\"reviewsLimit\", 3);\n}});" } ] } }, "/google-maps-photos" : { "get": { "summary": "Google Maps Photos", "description": "Returns Google Maps photos from places when using search queries (e.g., `restaurants, Manhattan, NY, USA`) or from a single place when using IDs or names (e.g., `NoMad Restaurant, NY, USA`, `0x886916e8bc273979:0x5141fcb11460b226`, `ChIJu7bMNFV-54gR-lrHScvPRX4`).\n\nIn case no photos were found by your search criteria, your search request will consume the usage of one photo.\n\n", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_maps_query"}, { "in": "query", "name": "photosLimit", "required": false, "description": "The parameter specifies the limit of photos to get from one place.", "schema": { "type": "integer", "default": 100 } }, {"$ref": "#/components/schemas/parameters/maps_reviews_limit"}, { "in": "query", "name": "tag", "required": false, "description": "Tne parameter specifies one of the filtering types.", "schema": { "type": "string", "enum": [ "all", "latest", "menu", "by_owner" ], "default": "all" } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": "The response contains the `status` of the request and `data`. Data is an array where each element represents a place with its photos.", "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps_photos"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-photos?query=Trump%20Tower,%20NY,%20USA&photosLimit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-photos?query=Trump%20Tower,%20NY,%20USA&photosLimit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.google_maps_photos('Trump Tower, NY, USA', photosLimit=3)" } ] } }, "/google-maps-directions" : { "get": { "summary": "Google Directions", "description": "Returns directions between two points from Google Maps.", "tags": ["Google"], "parameters": [ { "in": "query", "name": "origin", "required": true, "description": "The parameter defines the origin. You can use anything that you would use on Google Maps directions (e.g., `Lincoln Way & 19th Ave, San Francisco, USA`).\n\nIt supports batching by sending arrays with up to `1000` origins. It allows multiple directions to be sent in one request and save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "destination", "required": true, "description": "The parameter defines the destination. You can use anything that you would use on Google Maps directions (e.g., `19th Ave & Taraval St, San Francisco, USA`).\n\nIt supports batching by sending arrays with up to `1000` destinations. It allows multiple directions to be sent in one request and save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "departure_time", "required": false, "description": "The parameter specifies the departure timestamp.\n\nThe current timestamp is used when the value is not provided.", "schema": { "type": "integer" } }, { "in": "query", "name": "finish_time", "required": false, "description": "The parameter specifies the end departure timestamp.\n\nUsing this parameter requires using the `interval` parameter.", "schema": { "type": "integer" } }, { "in": "query", "name": "interval", "required": false, "description": "The parameter specifies the interval to use between departure_time and finish_time.", "schema": { "type": "integer" } }, { "in": "query", "name": "travel_mode", "required": false, "description": "Tne parameter specifies one of the travel modes.", "schema": { "type": "string", "enum": [ "best", "car", "transit", "walk", "bike", "flight" ], "default": "best" } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": "The response contains the `status` of the request and `data`.", "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps_directions"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-directions?origin=Lincoln%20Way%20&%2019th%20Ave,%20San%20Francisco,%20USA&destination=19th%20Ave%20&%20Taraval%20St,%20San%20Francisco,%20USA&departure_time=1598288400&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-directions?origin=Lincoln%20Way%20&%2019th%20Ave,%20San%20Francisco,%20USA&destination=19th%20Ave%20&%20Taraval%20St,%20San%20Francisco,%20USA&departure_time=1598288400\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.google_maps_directions(['29.696596, 76.994928 30.7159662444353, 76.8053887016268', '29.696596, 76.994928 30.723065, 76.770169'])" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.google_maps_directions(['29.696596, 76.994928 30.7159662444353, 76.8053887016268', '29.696596, 76.994928 30.723065, 76.770169'])" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->google_maps_directions(['29.696596, 76.994928 30.7159662444353, 76.8053887016268', '29.696596, 76.994928 30.723065, 76.770169']);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.googleMapsDirections(['29.696596, 76.994928 30.7159662444353, 76.8053887016268', '29.696596, 76.994928 30.723065, 76.770169']).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.GoogleMapsDirections(map[string]string {\n \"query\": \"29.696596, 76.994928 30.7159662444353, 76.8053887016268', 29.696596, 76.994928 30.723065, 76.770169\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.googleMapsDirections(new HashMap() {{\n put(\"query\", \"29.696596, 76.994928 30.7159662444353, 76.8053887016268', 29.696596, 76.994928 30.723065, 76.770169\");\n}});" } ] } }, "/google-search-autocomplete" : { "get": { "summary": "Google Search Autocomplete", "description": "Get automatic search suggestions for your queries on Google Search.", "tags": ["Google"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "The parameter specifies the search query (e.g., `outscraper`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_search_autocomplete"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-autocomplete?query=outscraper&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-autocomplete?query=outscraper\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-maps-suggestions" : { "get": { "summary": "Place Autocomplete", "description": "Get automatic search suggestions for your queries on Google Maps.", "tags": ["Google"], "parameters": [ { "in": "query", "name": "origin", "required": true, "description": "The parameter defines the query to search for suggestions (e.g., `5th Av`, `Central Pa`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "coordinates", "required": true, "description": "The latitude and longitude coordinates specifying the location for search (e.g., `37.427074,-122.1439166`, `40.7449819,-74.0271321`).", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" }, "default": "40.7449819,-74.0271321" } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id": "your-request-id", "status": "Success", "data": [{"query": "bars", "suggestions": ["bars", "Barstool Sports NY Headquarters, 7th Avenue, New York, NY", "Barstow, CA", "Barstool Sansom Street, Sansom Street, Philadelphia, PA", "Barstool Sports HQ, 7th Avenue, New York, NY"]}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-suggestions?query=bars&coordinates=40.7449819,-74.0271321&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-suggestions?query=bars&coordinates=40.7449819,-74.0271321\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-maps-autocomplete" : { "get": { "summary": "Google Maps Autocomplete", "description": "Get automatic search suggestions for your queries on Google Maps.", "tags": ["Google"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "The parameter defines the query to search for suggestions (e.g., `central`, `restaurant`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "coordinates", "required": false, "description": "Coordinates from Google Maps URL (e.g., '@23.4933124,53.9623381,11.42z'). Optional parameter to bias results towards a specific location.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" }, "default": "@23.4933124,53.9623381,11.42z" } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-autocomplete?query=bars&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-maps-autocomplete?query=bars\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-play-reviews" : { "get": { "summary": "Google Play Reviews", "description": "Returns reviews from any app/book/movie in the Google Play store.", "tags": ["Google", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use app IDs or direct links (e.g., `https://play.google.com/store/apps/details?id=com.facebook.katana`, `com.facebook.katana`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "Tne parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "most_relevant", "newest", "rating" ], "default": "most_relevant" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, { "in": "query", "name": "rating", "required": false, "description": "Filter by a specific rating. Works only with `sort=rating`.", "schema": { "type": "integer" } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_play_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-play-reviews?query=com.facebook.katana&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-play-reviews?query=com.facebook.katana&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.google_play_reviews('com.facebook.katana', reviewsLimit=3)" } ] } }, "/google-search" : { "get": { "summary": "Google Search", "description": "Returns search results from Google based on a given search query (or many queries). This endpoint is optimized for fast responses and can be used as a real-time API.", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/pages_per_query"}, {"$ref": "#/components/schemas/parameters/google_search_uule"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/google_search_tbs"}, {"$ref": "#/components/schemas/parameters/skip"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_search"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search?query=buy+iphone+13+TX&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search?query=buy+iphone+13+TX\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.google_search(['buy iphone 13 TX'])" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.google_search('buy iphone 13 TX')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->google_search(['buy iphone 13 TX']);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.googleSearchV3(['buy iphone 13 TX']).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.GoogleSearchV3(map[string]string {\n \"query\": \"buy iphone 13 TX\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.googleSearchV3(new HashMap() {{\n put(\"query\", \"buy iphone 13 TX\");\n}});" } ] } }, "/google-search-news" : { "get": { "summary": "Google Search News", "description": "Returns search results from Google News based on a given search query (or many queries).", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/pages_per_query"}, {"$ref": "#/components/schemas/parameters/google_search_uule"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/google_search_tbs"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_search_news"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-news?query=bitcoin&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-news?query=bitcoin\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-search-events" : { "get": { "summary": "Google Search Events", "description": "Returns search results from Google Events based on a given search query (or many queries).", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/pages_per_query"}, {"$ref": "#/components/schemas/parameters/google_search_uule"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_search_events"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-events?query=bitcoin&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-events?query=bitcoin\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-search-videos" : { "get": { "summary": "Google Search Videos", "description": "Returns search results from Google Videos based on a given search query (or many queries).", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/pages_per_query"}, {"$ref": "#/components/schemas/parameters/google_search_uule"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_search_videos"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-videos?query=outscraper&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-videos?query=outscraper\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-search-images" : { "get": { "summary": "Google Search Images", "description": "Returns images search results from Google based on a given search query (or many queries).", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/items_per_query"}, {"$ref": "#/components/schemas/parameters/google_search_uule"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_search_images"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-images?query=iphone&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-images?query=iphone\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-search-shopping" : { "get": { "summary": "Google Search Shopping", "description": "Returns products search results from Google based on a given search query (or many queries).", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/items_per_query"}, {"$ref": "#/components/schemas/parameters/google_search_uule"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_search_shopping"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-shopping?query=iphone&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-shopping?query=iphone\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-search-careers" : { "get": { "summary": "Google Search Careers", "description": "Allows scraping search results from Google Careers.", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/pages_per_query"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-careers?query=developer&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-careers?query=developer\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-search-jobs" : { "get": { "summary": "Google Search Jobs", "description": "Allows scraping search results from Google Jobs.", "tags": ["Google"], "parameters": [ {"$ref": "#/components/schemas/parameters/google_search_query"}, {"$ref": "#/components/schemas/parameters/pages_per_query"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-jobs?query=developer&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-search-jobs?query=developer\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-shopping-reviews" : { "get": { "summary": "Google Shopping Reviews", "description": "Returns reviews from Google product based on a given search query (or many queries).", "tags": ["Google", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Product links or product IDs (e.g., `https://www.google.com/shopping/product/7016166685587850095`, `7016166685587850095`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/items_per_query"}, {"$ref": "#/components/schemas/parameters/google_search_uule"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_shopping_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-shopping-reviews?query=7016166685587850095&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-shopping-reviews?query=7016166685587850095\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/google-trends" : { "get": { "summary": "Google Trends", "description": "Allows scraping results from Google Trends.", "tags": ["Google"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Queries to search (e.g., `tesla`, `tesla | toyota`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "timeframe", "required": false, "description": "The parameter specifies one of the timeframes.", "schema": { "type": "string", "enum": [ "now 1-H", "now 4-H", "now 1-d", "now 7-d", "today 1-m", "today 3-m", "today 12-m", "today 5-y", "all" ], "default": "now 1-d" } }, { "in": "query", "name": "resolution", "required": false, "description": "The parameter specifies one of the resolutions.", "schema": { "type": "string", "enum": [ "CITY", "COUNTRY", "DMA", "REGION" ], "default": "CITY" } }, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/google-trends?query=tesla&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/google-trends?query=tesla\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/reddit-comments" : { "get": { "summary": "Reddit Comments", "description": "Returns comments from Reddit.", "tags": ["Reviews & Comments", "Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Reddit post URLs (e.g., `https://www.reddit.com/r/AskReddit/comments/abcdef/example_post_title/`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": ["best", "top", "new", "controversial", "old", "qa"], "default": "best" } }, { "$ref": "#/components/schemas/parameters/fields" }, { "$ref": "#/components/schemas/parameters/async" }, { "$ref": "#/components/schemas/parameters/ui" }, { "$ref": "#/components/schemas/parameters/webhook" } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/reddit_comments"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/reddit-comments?query=https://www.reddit.com/r/squidgame/comments/1hzfvu8/poor_456/&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/reddit-comments?query=https://www.reddit.com/r/squidgame/comments/1hzfvu8/poor_456/\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/youtube-search" : { "get": { "summary": "YouTube Search", "description": "Returns search results from YouTube.", "tags": ["YouTube"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Queries to search on YouTube (e.g., `funny cats videos`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/youtube_search"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-search?query=cats&limit=1&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-search?query=cats&limit=1\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/youtube-videos" : { "get": { "summary": "YouTube Videos", "description": "Returns videos from YouTube channels.", "tags": ["YouTube"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "YouTube handles or YouTube channel URLs (e.g., `https://www.youtube.com/@outscraper`, `outscraper`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "shorts", "required": true, "description": "The parameter specifies whether to search only shorts `true` or only regular videos `false`.", "schema": { "type": "boolean", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/youtube_videos"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-videos?query=@Google&limit=1&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-videos?query=@Google&limit=1\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/youtube-channel" : { "get": { "summary": "YouTube Channels", "description": "Returns data from YouTube channels.", "tags": ["YouTube"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "YouTube handles or YouTube channel URLs (e.g., `https://www.youtube.com/@outscraper`, `outscraper`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/youtube_channel"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-channel?query=outscraper&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-channel?query=outscraper\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/youtube-comments" : { "get": { "summary": "YouTube Comments", "description": "Returns comments from YouTube videos.", "tags": ["YouTube", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Video links or video IDs (e.g., `https://www.youtube.com/watch?v=ph5pHgklaZ0`, `ph5pHgklaZ0`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/items_per_query"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/youtube_comments"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-comments?query=ph5pHgklaZ0&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-comments?query=ph5pHgklaZ0\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/youtube-transcripts" : { "get": { "summary": "YouTube Transcripts", "description": "Returns transcripts from YouTube videos.", "tags": ["YouTube"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Video links or video IDs (e.g., `https://www.youtube.com/watch?v=ph5pHgklaZ0`, `ph5pHgklaZ0`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/youtube_transcripts"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-transcripts?query=ph5pHgklaZ0&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/youtube-transcripts?query=ph5pHgklaZ0\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/tiktok-comments" : { "get": { "summary": "TikTok Comments", "description": "Returns comments from TikTok videos.", "tags": ["TikTok", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Video links or video IDs (e.g., `https://www.tiktok.com/@k1ra_lait/video/7529087250404019458`, `7529087250404019458`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "limit_per_query", "required": false, "description": "The parameter specifies the limit of comments to get from one video.", "schema": { "type": "integer", "default": 100 } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/tiktok_comments"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/tiktok-comments?query=https://www.tiktok.com/@k1ra_lait/video/7529087250404019458&limit_per_query=100&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/tiktok-comments?query=https://www.tiktok.com/@k1ra_lait/video/7529087250404019458&limit_per_query=100\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.tiktok_comments('https://www.tiktok.com/@k1ra_lait/video/7529087250404019458', limit_per_query=100)" } ] } }, "/indeed-search" : { "get": { "summary": "Indeed Job Search", "description": "Returns jobs from Indeed.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search links with search parameters (e.g., `https://www.indeed.com/jobs?q=&l=Fremont+Canyon%2C+CA`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/indeed_search"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/indeed-search?query=https%3A%2F%2Fwww.indeed.com%2Fjobs%3Fq%3D%26l%3DFremont%2BCanyon%252C%2BCA&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/indeed-search?query=https%3A%2F%2Fwww.indeed.com%2Fjobs%3Fq%3D%26l%3DFremont%2BCanyon%252C%2BCA&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/indeed-reviews" : { "get": { "summary": "Indeed Reviews", "description": "Returns reviews from Indeed companies.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links, and IDs of any Indeed company (e.g., `https://www.indeed.com/cmp/TEKsystems`, `TEKsystems`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "helpfulness", "rating_desc" ], "default": "" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/indeed_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/indeed-reviews?query=TEKsystems&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/indeed-reviews?query=TEKsystems&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/zillow-search" : { "get": { "summary": "Zillow Search", "description": "Returns listings from Zillow.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search links with search parameters (e.g., `Jacksonville, FL`, `https://www.zillow.com/jacksonville-fl/sold/?searchQueryState=...`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "mainFilter", "required": false, "description": "The parameter specifies the of the main filters.", "schema": { "type": "string", "enum": [ "for_sale", "for_rent", "sold" ], "default": "for_sale" } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/skip"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/zillow-search?query=Jacksonville%2C%20FL%26limit&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/zillow-search?query=Jacksonville%2C%20FL%26limit&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/yahoo-search" : { "get": { "summary": "Yahoo Search", "description": "Returns search results from Yahoo.", "tags": ["Others", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search links with search parameters (e.g., `https://search.yahoo.com/search?p=python+web+scraping`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/yahoo_data"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/yahoo-search?query=outscraper&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/yahoo-search?query=python&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/yelp-search" : { "get": { "summary": "Yelp Search", "description": "Returns search results from Yelp.", "tags": ["Others", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search links with search parameters (e.g., `https://www.yelp.com/search?find_desc=Restaurants&find_loc=San+Francisco%2C+CA`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/yelp_data"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/yelp-search?query=https%3A%2F%2Fwww.yelp.com%2Fsearch%3Ffind_desc%3DRestaurants%26find_loc%3DSan%2BFrancisco%252C%2BCA&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/yelp-search?query=https%3A%2F%2Fwww.yelp.com%2Fsearch%3Ffind_desc%3DRestaurants%26find_loc%3DSan%2BFrancisco%252C%2BCA&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/yelp-biz" : { "get": { "summary": "Yelp Business", "description": "Return business information from Yelp.", "tags": ["Yelp", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links, and IDs of any Yelp business (e.g., `https://www.yelp.com/biz/cancha-boutique-gastrobar-san-francisco`, `eggcellent-waffles-san-francisco`, `iXoLJWjbcXCO43RT-H0uQQ`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/yelp_biz_data"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/yelp-biz?query=eggcellent-waffles-san-francisco&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/yelp-biz?query=eggcellent-waffles-san-francisco\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/yellowpages-search" : { "get": { "summary": "Yellow Pages Search", "description": "Returns search results from Yellow Pages.", "tags": ["YellowPages", "Others", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Categories to search for (e.g., `bars`, `restaurants`, `dentists`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "location", "required": false, "description": "The parameter specifies where to search (e.g., `New York, NY`).", "schema": { "type": "string", "default": "New York, NY" } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/yellowpages"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/yellowpages-search?query=restaurants&location=New+York,+NY&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/yellowpages-search?query=restaurants&location=New+York,+NY&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/appstore-reviews" : { "get": { "summary": "AppStore Reviews", "description": "Returns reviews from AppStore apps.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links, and IDs of any AppStore app (e.g., `https://apps.apple.com/us/app/telegram-messenger/id686449807`, `id686449807`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "mosthelpful", "mostrecent" ], "default": "mosthelpful" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/appstore_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/appstore-reviews?query=https://apps.apple.com/us/app/telegram-messenger/id686449807&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/appstore-reviews?query=https://apps.apple.com/us/app/telegram-messenger/id686449807&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/glassdoor-reviews" : { "get": { "summary": "Glassdoor Reviews", "description": "Returns reviews from Glassdoor companies.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links to any Glassdoor company (e.g., `'https://www.glassdoor.com/Reviews/Amazon-Reviews-E6036.htm`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "DATE", "RELEVANCE" ], "default": "DATE" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/glassdoor_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/glassdoor-reviews?query=https%3A%2F%2Fwww.glassdoor.com%2FReviews%2FAmazon-Reviews-E6036.htm&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/glassdoor-reviews?query=https%3A%2F%2Fwww.glassdoor.com%2FReviews%2FAmazon-Reviews-E6036.htm&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/airbnb-search" : { "get": { "summary": "Airbnb Search", "description": "Returns search results from Airbnb.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Airbnb Search URLs (e.g., `https://www.airbnb.com/s/Italy/homes?tab_id=...`, https://www.airbnb.com/s/Paris/homes?tab_id=...`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/airbnb-search?query=https://www.airbnb.com/s/Italy/homes&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/airbnb-search?query=https://www.airbnb.com/s/Italy/homes&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/airbnb-reviews" : { "get": { "summary": "Airbnb Reviews", "description": "Returns reviews from Airbnb accommodations.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links, and IDs of any Airbnb accommodation (e.g., `https://www.airbnb.com/rooms/927539322986647456`, `1125445123101274851`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "MOST_RECENT", "RATING_DESC", "RATING_ASC" ], "default": "MOST_RECENT" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/airbnb_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/airbnb-reviews?query=https://www.airbnb.com/rooms/927539322986647456&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/airbnb-reviews?query=https://www.airbnb.com/rooms/927539322986647456&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/getapp-reviews" : { "get": { "summary": "GetApp Reviews", "description": "Returns reviews from GetApp apps.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links to any GetApp app (e.g., `https://www.getapp.com/customer-management-software/a/salesforce/reviews/`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "recommended", "most_recent", "least_recent", "highest_rated", "lowest_rated" ], "default": "recommended" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/getapp-reviews?query=https%3A%2F%2Fwww.getapp.com%2Fcustomer-management-software%2Fa%2Fsalesforce%2Freviews%2F&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/getapp-reviews?query=https%3A%2F%2Fwww.getapp.com%2Fcustomer-management-software%2Fa%2Fsalesforce%2Freviews%2F&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/booking-search" : { "get": { "summary": "Booking Search", "description": "Returns search results from Booking.com", "tags": ["Booking", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search links with search parameters (e.g., `https://www.booking.com/searchresults.html?ss=Rome%2C+Lazio%2C+Italy`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/booking_search"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/booking-search?query=https%3A%2F%2Fwww.booking.com%2Fsearchresults.html%3Fss%3DRome%252C%2BLazio%252C%2BItaly&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/booking-search?query=https%3A%2F%2Fwww.booking.com%2Fsearchresults.html%3Fss%3DRome%252C%2BLazio%252C%2BItaly&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/booking-reviews" : { "get": { "summary": "Booking Reviews", "description": "Returns reviews from Booking.com hotels.", "tags": ["Booking", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links, and IDs of any booking hotel (e.g., `https://www.booking.com/hotel/tr/old-town-point-amp-spa-antalya.html`, `old-town-point-amp-spa-antalya`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, {"$ref": "#/components/schemas/parameters/skip"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "f_recent_desc", "f_recent_asc", "f_score_desc", "f_score_asc" ], "default": "" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/booking_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/booking-reviews?query=https://www.booking.com/hotel/pl/aparthotel.fr.html&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/booking-reviews?query=https://www.booking.com/hotel/pl/aparthotel.fr.html&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/booking-prices" : { "get": { "summary": "Booking Prices", "description": "Returns prices from a list of hotels.", "tags": ["Booking"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links, and IDs of any booking hotel (e.g., `https://www.booking.com/hotel/tr/old-town-point-amp-spa-antalya.html`, `old-town-point-amp-spa-antalya`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/booking-prices?query=https://www.booking.com/hotel/pl/aparthotel.fr.html&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/booking-prices?query=https://www.booking.com/hotel/pl/aparthotel.fr.html&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/hotels-search" : { "get": { "summary": "Hotels.com Search", "description": "Returns search results from Hotels.com", "tags": ["Others", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search links with search parameters (e.g., `https://www.hotels.com/Hotel-Search?destination=Toronto%2C%20Ontario%2C%20Canada®ionId=4089&sort=RECOMMENDED`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/hotels_search"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/hotels-search?query=https%3A%2F%2Fwww.hotels.com%2FHotel-Search%3Fdestination%3DToronto%252C%2520Ontario%252C%2520Canada%26regionId%3D4089%26sort%3DRECOMMENDED&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/hotels-search?query=https%3A%2F%2Fwww.hotels.com%2FHotel-Search%3Fdestination%3DToronto%252C%2520Ontario%252C%2520Canada%26regionId%3D4089%26sort%3DRECOMMENDED&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/deliveroo" : { "get": { "summary": "Deliveroo", "description": "Returns Deliveroo listings.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "URLs to Deliveroo menu items (e.g., `https://deliveroo.co.uk/menu/london/strand/thunderbird-fried-chicken-villiers-st`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/deliveroo?query=https://deliveroo.fr/fr/menu/Paris/batignolles/burger-king-paris-porte-de-clichy&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/deliveroo?query=https://deliveroo.fr/fr/menu/Paris/batignolles/burger-king-paris-porte-de-clichy&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/deliveroo-reviews" : { "get": { "summary": "Deliveroo Reviews", "description": "Returns reviews from Deliveroo.", "tags": ["Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "URLs to Deliveroo menu items (e.g., `https://deliveroo.co.uk/menu/london/strand/thunderbird-fried-chicken-villiers-st`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "highest_rated", "lowest_rated", "newest", "oldest" ], "default": "highest_rated" } }, { "in": "query", "name": "cutoff", "required": false, "description": "The parameter specifies the oldest timestamp value for reviews. \n\nUsing the `cutoff` parameter overwrites `sort` parameter to `newest`. Therefore, the latest reviews will be at the beginning.", "schema": { "type": "integer" } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/deliveroo-reviews?query=https://deliveroo.fr/fr/menu/Paris/batignolles/burger-king-paris-porte-de-clichy&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/deliveroo-reviews?query=https://deliveroo.fr/fr/menu/Paris/batignolles/burger-king-paris-porte-de-clichy&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/capterra-reviews" : { "get": { "summary": "Capterra Reviews", "description": "Returns reviews from Capterra.", "tags": ["Capterra", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Capterra product pages (e.g., `https://www.capterra.com/p/228041/Google-Maps-scraper/`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "HIGHEST_COMPLETENESS_SCORE", "MOST_RECENT", "HIGHEST_RATING", "LOWEST_RATING" ], "default": "HIGHEST_COMPLETENESS_SCORE" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/capterra_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/capterra-reviews?query=https://www.capterra.com/p/228041/Google-Maps-scraper/&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/capterra-reviews?query=https://www.capterra.com/p/228041/Google-Maps-scraper/&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/producthunt-reviews" : { "get": { "summary": "Product Hunt Reviews", "description": "Returns reviews from Product Hunt.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Product Hunt product pages, or page IDs (e.g., `https://www.producthunt.com/products/outscraper`, `outscraper`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, {"$ref": "#/components/schemas/parameters/cursor"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "BEST", "LATEST", "FAVORABLE", "CRITICAL" ], "default": "BEST" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/region"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/producthunt_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/producthunt-reviews?query=outscraper&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/producthunt-reviews?query=outscraper&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/yelp-reviews" : { "get": { "summary": "Yelp Reviews", "description": "Returns reviews from Yelp businesses.\n\nIn case no reviews were found by your search criteria, your search request will consume the usage of one review.", "tags": ["Yelp", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links, and IDs of any Yelp business (e.g., `https://www.yelp.com/biz/cancha-boutique-gastrobar-san-francisco`, `eggcellent-waffles-san-francisco`, `iXoLJWjbcXCO43RT-H0uQQ`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, {"$ref": "#/components/schemas/parameters/cursor"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "relevance_desc", "date_desc", "date_asc", "rating_desc", "rating_asc", "elites_desc" ], "default": "relevance_desc" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/yelp_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/yelp-reviews?query=eggcellent-waffles-san-francisco&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/yelp-reviews?query=eggcellent-waffles-san-francisco&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/expedia-search" : { "get": { "summary": "Expedia Search", "description": "Returns search results from expedia.com", "tags": ["Expedia", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search links with search parameters (e.g., `https://www.expedia.com/Hotel-Search?destination=Ankara...`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/expedia_search"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/expedia-search?query=https://www.expedia.com/Hotel-Search?destination=Ankara...&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/expedia-search?query=https://www.expedia.com/Hotel-Search?destination=Ankara...&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/expedia-reviews" : { "get": { "summary": "Expedia Reviews", "description": "Returns reviews from expedia.com places.", "tags": ["Expedia", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use direct links of any expedia place, or place IDs (e.g., `https://www.expedia.com/Las-Vegas-Hotels-The-Orleans-Hotel-Casino.h41313.Hotel-Information`, `41313`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "NEWEST_TO_OLDEST_BY_LANGUAGE", "NEWEST_TO_OLDEST", "HIGHEST_TO_LOWEST_RATED", "LOWEST_TO_HIGHEST_RATED" ], "default": "NEWEST_TO_OLDEST_BY_LANGUAGE" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/expedia_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/expedia-reviews?query=https://www.expedia.com/Las-Vegas-Hotels-The-Orleans-Hotel-Casino.h41313.Hotel-Information&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/expedia-reviews?query=https://www.expedia.com/Las-Vegas-Hotels-The-Orleans-Hotel-Casino.h41313.Hotel-Information&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/trustpilot" : { "get": { "summary": "Trustpilot", "description": "Returns data from Trustpilot businesses.", "tags": ["Trustpilot", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Trustpilot pages or domain names (e.g., `outscraper.com`, `https://www.trustpilot.com/review/outscraper.com`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/trustpilot_data"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/trustpilot?query=outscraper.com&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/trustpilot?query=outscraper.com\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/trustpilot-search" : { "get": { "summary": "Trustpilot Search", "description": "Returns search resutls from Trustpilot.", "tags": ["Trustpilot", "Businesses & POI"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Company or category to search on Trustpilot (e.g., `real estate`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/skip"}, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/trustpilot_data"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/trustpilot-search?query=real+estate&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/trustpilot-search?query=real+estate\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/trustpilot-reviews" : { "get": { "summary": "Trustpilot Reviews", "description": "Returns reviews from Trustpilot businesses.\n\nIn case no reviews were found by your search criteria, your search request will consume the usage of one review.", "tags": ["Trustpilot", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Trustpilot pages or domain names (e.g., `outscraper.com`, `https://www.trustpilot.com/review/outscraper.com`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, {"$ref": "#/components/schemas/parameters/skip20multiple"}, { "in": "query", "name": "languages", "required": false, "description": "The parameter specifies one of the language filters.", "schema": { "type": "string", "enum": [ "default", "all", "en", "es", "de" ], "default": "default" } }, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "recency" ], "default": "" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/trustpilot_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/trustpilot-reviews?query=outscraper.com&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/trustpilot-reviews?query=outscraper.com&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/tripadvisor-reviews" : { "get": { "summary": "Tripadvisor Reviews", "description": "Returns reviews from Tripadvisor businesses.\n\nIn case no reviews were found by your search criteria, your search request will consume the usage of one review.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Tripadvisor pages (e.g., `https://www.tripadvisor.com/Restaurant_Review-g187147-d12947099-Reviews-Mayfair_Garden-Paris_Ile_de_France.html`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, {"$ref": "#/components/schemas/parameters/cutoff"}, { "in": "query", "name": "language", "required": false, "description": "The parameter specifies the language to use for website.", "schema": { "type": "string", "enum": [ "default", "all" ], "default": "default" } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/tripadvisor_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/tripadvisor-reviews?query=https://www.tripadvisor.com/Restaurant_Review-g187147-d12947099-Reviews-Mayfair_Garden-Paris_Ile_de_France.html&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/tripadvisor-reviews?query=https://www.tripadvisor.com/Restaurant_Review-g187147-d12947099-Reviews-Mayfair_Garden-Paris_Ile_de_France.html&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/tripadvisor-search" : { "get": { "summary": "Tripadvisor Search", "description": "Returns from search results Tripadvisor", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Search keywords or links with search parameters (e.g., `https://www.tripadvisor.com/Search?q=hotels+animators`, `hotels animators`). It supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). This allows multiple queries to be sent in one request, helping to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "SearchType", "required": false, "description": "The parameter specifies the type of search results you want to retrieve from Tripadvisor. You can choose from the following options:\n\n- 'a' for All Results: Returns all available results for the search query.\n- 'h' for Hotels: Filters results to show only hotels.\n- 'e' for Restaurants: Filters results to show only restaurants.\n- 'A' for Things to Do: Filters results to show activities and attractions.\n- 'v' for Vacation Rentals: Filters results to show vacation rental properties.", "schema": { "type": "string", "enum": [ "a", "h", "e", "A", "v" ], "default": "a" } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/skip"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "204": {"$ref": "#/components/schemas/responses/204"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/tripadvisor_search"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/tripadvisor-search?query=https%3A%2F%2Fwww.tripadvisor.com%2FSearch%3Fq%3Drome&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/tripadvisor-search?query=https%3A%2F%2Fwww.tripadvisor.com%2FSearch%3Fq%3Drome&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/g2-reviews" : { "get": { "summary": "G2 Reviews", "description": "Returns reviews from a list of products.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to G2 products (e.g., `https://www.g2.com/products/outscraper`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "g2_default", "most_recent", "most_helpful", "highest_rated", "lowest_rated" ], "default": "g2_default" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/g2_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/g2-reviews?query=https://www.g2.com/products/outscraper&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/g2-reviews?query=https://www.g2.com/products/outscraper&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/amazon-products" : { "get": { "summary": "Amazon Products", "description": "Returns information about products on Amazon.", "tags": ["Amazon", "Products & Listings"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use Amazon products, searches, or summary page URLs. \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "limit", "required": false, "description": "The parameter specifies the limit of products to get from one query (in case of using summary pages).", "schema": { "type": "integer", "default": 24 } }, {"$ref": "#/components/schemas/parameters/amazon_domain"}, { "in": "query", "name": "postal_code", "required": false, "description": "The parameter specifies the postal code for delivery.", "schema": { "type": "string", "default": "11201" } }, {"$ref": "#/components/schemas/parameters/language"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/amazon_products"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/amazon-products?query=https://www.amazon.com/dp/B00G3XWLR8&limit=1&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/amazon-products?query=https://www.amazon.com/dp/B00G3XWLR8&limit=1\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.amazon_products('https://www.amazon.com/dp/B00G3XWLR8', limit=3)" } ] } }, "/amazon-reviews" : { "get": { "summary": "Amazon Reviews", "description": "Returns product's reviews from Amazon.", "tags": ["Amazon", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "You can use URLs or ASINs from Amazon products (e.g., `https://www.amazon.com/dp/1612680194`, `1612680194`, etc.). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "limit", "required": false, "description": "The parameter specifies the limit of reviews to get from one query. Maximum is `12`.", "schema": { "type": "integer", "default": 10 } }, {"$ref": "#/components/schemas/parameters/amazon_domain"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/amazon_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/amazon-reviews?query=https://www.amazon.com/dp/1612680194&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/amazon-reviews?query=https://www.amazon.com/dp/1612680194&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.amazon_reviews('https://www.amazon.com/dp/B00G3XWLR8', limit=3)" } ] } }, "/walmart-reviews" : { "get": { "summary": "Walmart Reviews", "description": "Returns reviews from a list of products.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Walmart products (e.g., `https://www.walmart.com/ip/Blackstone-Original-4-Burner-36-Propane-Omnivore-Griddle-with-Hard-Cover/1347629739`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "relevancy", "helpful", "submission-desc", "submission-asc", "rating-desc", "rating-asc" ], "default": "relevancy" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/walmart_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/walmart-reviews?query=https://www.walmart.com/ip/Blackstone-Original-4-Burner-36-Propane-Omnivore-Griddle-with-Hard-Cover/1347629739&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/walmart-reviews?query=https://www.walmart.com/ip/Blackstone-Original-4-Burner-36-Propane-Omnivore-Griddle-with-Hard-Cover/1347629739&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/target-reviews" : { "get": { "summary": "Target Reviews", "description": "Returns reviews from a list of products.", "tags": ["Others", "Reviews & Comments"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Target products (e.g., `https://www.target.com/p/apple-iphone-15-pro-max/-/A-89957794`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/reviews_limit"}, { "in": "query", "name": "sort", "required": false, "description": "The parameter specifies one of the sorting types.", "schema": { "type": "string", "enum": [ "most_recent", "highest_rating", "lowest_rating", "helpfulness_desc" ], "default": "most_recent" } }, {"$ref": "#/components/schemas/parameters/cutoff"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/target_reviews"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/target-reviews?query=https://www.target.com/p/apple-iphone-15-pro-max/-/A-89957794&limit=3&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/target-reviews?query=https://www.target.com/p/apple-iphone-15-pro-max/-/A-89957794&limit=3\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/twitter-profiles" : { "get": { "summary": "Twitter Profiles", "description": "Returns information from the list of Twitter profiles.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Twitter pages or page usernames (e.g., `https://www.twitter.com/outscraper`, `outscraper`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/twitter-profiles?query=outscraper&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/twitter-profiles?query=outscraper\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/tiktok-profiles" : { "get": { "summary": "Tiktok Profiles", "description": "Returns information from the list of TikTok profiles.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to Tiktok pages or page usernames (e.g., `https://www.tiktok.com/@outscraper`, `outscraper`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/tiktok-profiles?query=outscraper&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/tiktok-profiles?query=outscraper\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/linkedin-profiles" : { "get": { "summary": "Linkedin Profiles", "description": "Returns information from the list of Linkedin profiles.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "URLs to profiles or profile IDs (e.g., `https://www.linkedin.com/in/realvlad/`, `realvlad`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/linkedin-profiles?query=realvlad&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/linkedin-profiles?query=realvlad\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/linkedin-companies" : { "get": { "summary": "Linkedin Companies", "description": "Returns information from the list of Linkedin companies.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "URLs to companies or company IDs (e.g., `https://www.linkedin.com/company/outscraper/`, `outscraper`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/linkedin-companies?query=outscraper&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/linkedin-companies?query=outscraper\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/linkedin-posts" : { "get": { "summary": "Linkedin Posts", "description": "Returns posts from Linkedin companies.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "URLs to companies or company IDs (e.g., `https://www.linkedin.com/company/outscraper/`, `outscraper`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/limit"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/linkedin-posts?query=outscraper&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/linkedin-posts?query=outscraper\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/contacts-and-leads" : { "get": { "summary": "Contacts & Leads", "description": "Finds emails, social links, phones, and other contacts from websites.", "tags": ["Email Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Domain or link (e.g., `outscraper.com`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/preferredContacts"}, {"$ref": "#/components/schemas/parameters/contactsPerCompany"}, {"$ref": "#/components/schemas/parameters/emailsPerContact"}, {"$ref": "#/components/schemas/parameters/skipContacts"}, {"$ref": "#/components/schemas/parameters/generalEmails"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/contacts_n_leads"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/contacts-and-leads?query=outscraper.com&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/contacts-and-leads?query=outscraper.com\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.contacts_and_leads(['outscraper.com'])" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.contacts_and_leads('outscraper.com')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->contacts_and_leads(['outscraper.com']);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.contactsAndLeads(['outscraper.com']).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.ContactsAndLeads(map[string]string {\n \"query\": \"outscraper.com\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.contactsAndLeads(new HashMap() {{\n put(\"query\", \"outscraper.com\");\n}});" } ] } }, "/emails-and-contacts" : { "get": { "summary": "Emails & Contacts", "description": "Allows finding email addresses, social links, and phones from domains.", "tags": ["Email Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Domain or link (e.g., `outscraper.com`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/preferredContacts"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/domain_emails"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/emails-and-contacts?query=outscraper.com&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/emails-and-contacts?query=outscraper.com\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.emails_and_contacts(['outscraper.com'])" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.emails_and_contacts('outscraper.com')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->emails_and_contacts(['outscraper.com']);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.emailsAndContacts(['outscraper.com']).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.EmailsAndContacts(map[string]string {\n \"query\": \"outscraper.com\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.emailsAndContacts(new HashMap() {{\n put(\"query\", \"outscraper.com\");\n}});" } ] } }, "/email-validator" : { "get": { "summary": "Email Address Verifier", "description": "Allows to validate email addresses. Checks if emails are deliverable.", "tags": ["Email Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Email address (e.g., `support@outscraper.com`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/emails_validator"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/validators/email?query=support@outscraper.com&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/validators/email?query=support@outscraper.com\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/disposable-email-checker" : { "get": { "summary": "Disposable Email Checker", "description": "Checks origins of email addresses (disposable, free, or corporate)", "tags": ["Email Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Email address (e.g., `support@outscraper.com`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/disposable-email-checker?query=support@outscraper.com\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/emails-finder" : { "get": { "summary": "Email Addresses Finder", "description": "Finds professional emails by names.", "tags": ["Email Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Full name + company domain (e.g., `John Doe company.com`, `Dana outscraper.com`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/emails-finder?query=Dana%20outscraper.com&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/emails-finder?query=Dana%20outscraper.com\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/phones-enricher" : { "get": { "summary": "Phone Numbers Enricher", "description": "Returns phone carrier data (name/type), validates phones and ensures messages deliverability.", "tags": ["Phone Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Phone number (e.g., `+1 281 236 8208`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/phones_enricher"}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/phones-enricher?query=12812368208\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.phones_enricher(['12812368208'])" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.phones_enricher('12812368208')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->phones_enricher(['12812368208']);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.phonesEnricher(['12812368208']).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.PhonesEnricher(map[string]string {\n \"query\": \"12812368208\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.phonesEnricher(new HashMap() {{\n put(\"query\", \"12812368208\");\n}});" } ] } }, "/whatasp-checker" : { "get": { "summary": "WhatsApp Checker", "description": "Checks whether a phone is connected to the service.", "tags": ["Phone Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Phone number (e.g., `+1 281 236 8208`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id":"your-request-id","status":"Success","data":[{"query":"12812368208","connected":false}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/whatasp-checker?query=12812368208\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/whitepages-phones" : { "get": { "summary": "Phone Identity Finder (Whitepages)", "description": "Returns insights about phone number owners (name, address, etc.).", "tags": ["Phone Related", "Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Phone number (e.g., `+1 281 236 8208`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id":"your-request-id","status":"Success","data":[{"query":"12812368208"}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/whitepages-phones?query=12812368208\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/phones-owners" : { "get": { "summary": "Phones Owners", "description": "Returns insights about phone number owners (name, address, etc.).", "tags": ["Phone Related", "Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Phone number (e.g., `+1 281 236 8208`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id":"your-request-id","status":"Success","data":[{"query":"12812368208"}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/phones-owners?query=12812368208\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/whitepages-addresses" : { "get": { "summary": "Whitepages Addresses Scraper", "description": "Returns insights about addresses and their residents.", "tags": ["Others"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Addresses (e.g., `321 California Ave, Palo Alto, CA 94306`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id":"your-request-id","status":"Success","data":[{"query":"321 California Ave, Palo Alto, CA 94306"}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/whitepages-addresses?query=321%20California%20Ave%2C%20Palo%20Alto%2C%20CA%2094306\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/geocoding" : { "get": { "summary": "Geocoding", "description": "Translates human-readable addresses into locations on the map (latitude, longitude).", "tags": ["Other Services"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Addresses specifying the location for which you want to get the coordinates (e.g., `321 California Ave, Palo Alto, CA 94306`, `Central Park, NY`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id": "your-request-id", "status": "Success", "data": [{"query": "321 California Ave, Palo Alto, CA 94306", "latitude": 37.4270502, "longitude": -122.14384609999999, "country": "United States of America", "state": "California", "city": "Palo Alto", "borough": "Evergreen Park", "street": "321 California Ave", "postal_code": "94306", "time_zone": "America/Los_Angeles", "street_view": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=DToAt0TizIuNUSxC5MZkXQ&cb_client=search.gws-prod.gps&w=1600&h=1000&yaw=150.42152&pitch=0&thumbfov=100"}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/geocoding?query=321%20California%20Ave%2C%20Palo%20Alto%2C%20CA%2094306\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/reverse-geocoding" : { "get": { "summary": "Reverse Geocoding", "description": "Translate locations on the map into human-readable addresses.", "tags": ["Other Services"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "The latitude and longitude coordinates specifying the location for which you want the closest, human-readable address (e.g., `40.7624284 -73.973794`, `37.427074,-122.1439166`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } } ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id": "your-request-id", "status": "Success", "data": [{"query": "40.7624284,-73.973794", "address": "725 5th Ave, New York, NY 10022", "city": "New York", "country_code": "US", "county": "Manhattan", "photo": "https://lh5.googleusercontent.com/p/AF1QipNTlWz6ZZk9wZlktzx-VcNyfXaYrf9VVreGcFeH=w800-h500-k-no", "plus_code": "725 5th ave", "postal_code": "10022", "state": "NY", "street": "725 5Th Ave", "time_zone": "America/New_York"}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/reverse-geocoding?query=40.7624284,-73.973794\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/company-website-finder" : { "get": { "summary": "Company Website Finder", "description": "Finds company websites based on business names.", "tags": ["Domain Related"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Business names (e.g., `Apple Inc`, `Microsoft Corporation`, `Tesla Motors`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id": "your-request-id", "status": "Success", "data": [{"query":"Apple Inc","company_name":"Apple Inc.","website":"https://www.apple.com","domain":"apple.com","confidence_score":0.95}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/company-website-finder?query=Apple%20Inc&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/company-website-finder?query=Apple%20Inc\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.company_websites_finder(['Apple Inc'])" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.company_websites_finder('Apple Inc')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->company_websites_finder(['Apple Inc']);" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.companyWebsiteFinder(['Apple Inc']).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.CompanyWebsiteFinder(map[string]string {\n \"query\": \"Apple Inc\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.companyWebsiteFinder(new HashMap() {{\n put(\"query\", \"Apple Inc\");\n}});" } ] } }, "/company-insights" : { "get": { "summary": "Company Insights", "description": "Finds company firmographics such as revenue, size, founding year, public status, etc.", "tags": ["Other Services"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Domains or websites (e.g., `dominopark.com`, `https://www.esbnyc.com/`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/enrichments"}, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id": "your-request-id", "status": "Success", "data": [{"query":"apple.com","address":"1 Apple Park Way","city":"Cupertino","country":"United States","description":"Apple is a multinational corporation known for designing, manufacturing, and marketing consumer electronics, personal computers, and software. Their innovative product development and world-class operations have made them a leader in the industry, with...","employees":"100000","facebook_company_page":"https://facebook.com/137947732957611","founded_year":"1976","industry":"COMPUTER_SOFTWARE","is_public":"true","linkedin_bio":"Apple is a multinational corporation known for designing, manufacturing, and marketing consumer electronics, personal computers, and software. Their innovative product development and world-class operations have made them a leader in the industry, with...","linkedin_company_page":"https://www.linkedin.com/company/apple","name":"Apple Inc.","phone":"+1 408-996-1010","revenue":"10000000000","state":"CA","timezone":"America/Los_Angeles","total_money_raised":"3.3B","zip":"95014","twitter_handle":"Apple"}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/company-insights?query=apple.com&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/company-insights?query=apple.com\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/similarweb" : { "get": { "summary": "SimilarWeb Scraper", "description": "Returns website analytics data including traffic, rankings, audience insights, and competitive intelligence from SimilarWeb.", "tags": ["Domain Related"], "parameters": [ { "in": "query", "name": "domain", "required": true, "description": "Domains or websites (e.g., `apple.com`, `https://www.google.com/`). \n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id":"your-request-id", "status":"Success","data":[{"query":"apple.com","overview":{"global_rank":87,"global_rank_change":1,"category_rank":1,"category_rank_change":0,"country_rank":66,"country_rank_change":3,"country_alpha2_code":"US","bounce_rate":0.5243936157809659,"pages_per_visit":3.117111176387203,"visits_avg_duration_formatted":"00:02:27","company_name":"Apple","company_year_founded":1976,"company_employees_min":10001,"company_revenue_min":1000000000}}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/similarweb?query=apple.com&country=US&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/similarweb?query=apple.com&country=US\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.similarweb(['apple.com'], country='US')" }, { "lang": "Ruby", "source": "require 'Outscraper'\n\nclient = Outscraper::Client.new('SECRET_API_KEY')\nresults = client.similarweb('apple.com', country: 'US')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->similarweb(['apple.com'], $country='US');" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.similarweb(['apple.com'], {country: 'US'}).then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.SimilarWeb(map[string]string {\n \"query\": \"apple.com\",\n \"country\": \"US\",\n})" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.similarweb(new HashMap() {{\n put(\"query\", \"apple.com\");\n put(\"country\", \"US\");\n}});" } ] } }, "/universal-scraper" : { "get": { "summary": "Universal AI-Powered Scraper", "description": "Extracts the data you need from any web page by using AI.", "tags": ["Other Services"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to web pages (e.g., `https://www.apple.com/iphone/`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "attributes", "required": false, "description": "The parameter defines attributes to parse from a web page (e.g., `attributes=name,price,discount price,description`).", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "limit", "required": false, "description": "The parameter specifies the limit of pages to return from one query.", "schema": { "type": "integer", "default": 1 } }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id": "your-request-id", "status": "Success", "data": [{"query":"https://www.apple.com/iphone/","name":"iPhone","price":"$799","description":"The ultimate smartphone from Apple, with advanced features, powerful performance, and a sleek design."}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/universal-scraper?query=https://www.apple.com/iphone/&attributes=name,price,description&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/universal-scraper?query=https://www.apple.com/iphone/&attributes=name,price,description\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/screenshoter" : { "get": { "summary": "WebPage Screenshoter", "description": "Captures high-quality screenshots of any webpage simply by providing its URL", "tags": ["Other Services"], "parameters": [ { "in": "query", "name": "query", "required": true, "description": "Links to web pages (e.g., `https://www.apple.com/iphone/`).\n\nIt supports batching by sending arrays with up to `1000` queries (e.g., `query=text1&query=text2&query=text3`). It allows multiple queries to be sent in one request and to save on network latency time.", "schema": { "type": "array", "collectionFormat": "csv", "items": { "type": "string" } } }, { "in": "query", "name": "region", "required": false, "description": "The parameter specifies the country to use for the screenshot.", "schema": { "$ref": "#/components/schemas/region" } }, { "in": "query", "name": "type", "required": false, "description": "The parameter specifies the image extension.", "schema": { "type": "string", "enum": [ "webp", "png", "jpeg", "pdf" ], "default": "webp" } }, { "in": "query", "name": "fullPage", "required": false, "description": "The parameter specifies whether to capture the full page. It overrides the viewport height.", "schema": {"type": "boolean", "default": false} }, { "in": "query", "name": "width", "required": false, "description": "The parameter specifies the width of the viewport.", "schema": {"type": "integer", "default": 1200} }, { "in": "query", "name": "height", "required": false, "description": "The parameter specifies the height of the viewport.", "schema": {"type": "integer", "default": 800} }, {"$ref": "#/components/schemas/parameters/fields"}, {"$ref": "#/components/schemas/parameters/async"}, {"$ref": "#/components/schemas/parameters/ui"}, {"$ref": "#/components/schemas/parameters/format"}, {"$ref": "#/components/schemas/parameters/webhook"} ], "responses": { "202": {"$ref": "#/components/schemas/responses/202"}, "401": {"$ref": "#/components/schemas/responses/401"}, "402": {"$ref": "#/components/schemas/responses/402"}, "422": {"$ref": "#/components/schemas/responses/422"}, "200": { "description": {"$ref": "#/components/schemas/results/description/common"}, "content": {"application/json": {"example": {"id": "your-request-id", "status": "Success", "data": [{"query":"https://outscraper.com","screenshot":"https://os-storage.b-cdn.net/2024/12/10/1ec3016b-c3fa-4248-8a5c-73ad27e98f82.webp"}]}}} } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/screenshoter?query=https://www.apple.com/iphone&async=false\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "cURL (async)", "source": "curl -X GET \"https://api.outscraper.cloud/screenshoter?query=https://www.apple.com/iphone\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/requests/{requestId}" : { "get": { "summary": "Request Results", "description": "Allows you to fetch responses from requests created with async API endpoints. You can fetch responses before the expiration time by request ID, or use webhooks to get the data once it's ready.\n\nRequest status can be Pending, Success, or Failure. Each response is available for `4` hours after a request has been completed. Once the response is expired the status will be `Pending` again.", "tags": [ "Requests" ], "parameters": [ { "in": "path", "name": "requestId", "required": true, "description": "Request ID provided by API endpoints at `[\"id\"]`. Example: `32692d16-725c-4e66-b013-95e80e873b7e`", "schema": { "type": "string" } }, { "in": "query", "name": "flat", "required": false, "description": "The parameter allows you to return flat results. All the results from queries will be combined in one array.", "schema": { "type": "boolean", "default": false } }, { "in": "query", "name": "convertFileResult", "required": false, "description": "The parameter allows you to return only the link to the file result (`&convertFileResult=false`) without converting it to a JSON array.\n\nWorks only for UI tasks where results are stored in files.", "schema": { "type": "boolean", "default": true } } ], "responses": { "200": { "description": "The response contains the `status` of the request and `data` in case the request is finished.", "content": {"application/json": {"example": {"$ref": "#/components/schemas/results/google_maps"}}} }, "204": {"$ref": "#/components/schemas/responses/204"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/requests/your-request-id\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.get_request_archive('your-request-id')" }, { "lang": "PHP", "source": "$client = new OutscraperClient('YOUR-API-KEY');\n$results = $client->get_request_archive('your-request-id');" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.getRequestArchive('your-request-id').then(response => {\n console.log(response);\n});" }, { "lang": "Go", "source": "import \"github.com/outscraper/outscraper-go\"\n\nclient := outscraper.Client{ApiKey: \"SECRET_API_KEY\"}\nresults, _ := client.GetRequestArchive('your-request-id')" }, { "lang": "Java", "source": "OutscraperClient client = new OutscraperClient(\"SECRET_API_KEY\");\nJSONArray results = client.getRequestArchive(\"your-request-id\");" } ] }, "delete": { "summary": "Terminate Request", "description": "Allows you to terminate created requests.", "tags": [ "Requests" ], "parameters": [ { "in": "path", "name": "requestId", "required": true, "description": "Request ID provided by API endpoints at `[\"id\"]`. Example: `32692d16-725c-4e66-b013-95e80e873b7e`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Request terminated.", "content": { "application/json": { "example": "Request 17dd74fc-242b-4fdc-b518-009502768cf3 terminated" } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X DELETE \"https://api.outscraper.cloud/requests/your-request-id\"" } ] } }, "/requests" : { "get": { "summary": "Requests History", "description": "Fetch up to `100` latest requests during the last `24` hours.", "tags": [ "Requests" ], "parameters": [ { "in": "query", "name": "type", "required": false, "description": "The parameter allows you to filter requests by type (running/finished).", "schema": { "type": "string", "enum": [ "running", "finished" ], "default": "running" } }, {"$ref": "#/components/schemas/parameters/skip"}, { "in": "query", "name": "pageSize", "required": false, "description": "The parameter specifies the number of requests to return.", "schema": { "type": "integer", "default": 20 } } ], "responses": { "200": { "description": "Your latest request.", "content": { "application/json": { "example": [ { "id": "79e6d350-c6c9-449c-a890-7fe14f821ebe", "usage": "3" }, { "id": "15188338-029a-4d0c-afdd-318e8808d8fe", "usage": "10" }, { "id": "fd96b82c-6b37-49f0-b69f-b5c793d28284", "usage": "12" } ] } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/requests?type=finished\" -H \"X-API-KEY: YOUR-API-KEY\"" }, { "lang": "Python", "source": "from outscraper import OutscraperClient\n\napi_client = OutscraperClient(api_key='YOUR-API-KEY')\nresults = api_client.get_requests_history('finished')" }, { "lang": "Node.js", "source": "const Outscraper = require('outscraper');\n\nlet client = new Outscraper('YOUR-API-KEY');\nclient.getRequestsHistory('finished').then(response => {\n console.log(response);\n});" } ] } }, "/tasks" : { "get": { "summary": "Get Tasks", "description": "Fetch user tasks.", "tags": [ "Platform & Dashboard" ], "parameters": [ { "in": "query", "name": "query", "required": false, "description": "The parameter specifies the tag to search among the tasks.", "schema": { "type": "string" } }, { "in": "query", "name": "lastId", "required": false, "description": "The parameter specifies the last task ID. Used for pagination.", "schema": { "type": "string" } }, { "in": "query", "name": "pageSize", "required": false, "description": "The parameter specifies the number of items to return.", "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "User tasks.", "content": { "application/json": { "example": {"tasks":[{"metadata":{"service_name":"google_maps_service_v2","queries":["bars ny usa","restaurants ny usa"]},"updated":"2022-02-08T20:51:17.402668","user_id":"YOUR_USER_ID","status":"SUCCESS","created":"2022-02-08T20:49:06.879078","queue_task_id":"2b9aa187-281a-4d4e-a4c6-fbe941aaac34","results":[{"product_name":"Google Maps Data","file_url":"LINK_TO_RESULTS","quantity":509.0},{"product_name":"Domains","quantity":509.0}],"id":"YOUR_TASK_ID"}],"has_more":true} } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/tasks\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] }, "post": { "summary": "Create Task", "description": "Allows you to create UI tasks.", "tags": [ "Platform & Dashboard" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "service_name": {"type": "string", "description": "ID of the service you want to use (e.g., `google_maps_service_v2`, `google_maps_reviews_service_v3`)."}, "queries": {"type": "array", "collectionFormat": "csv", "items": {"type": "string"}, "description": "Queries to search for (e.g., `restaurants ny usa`, `bars ny usa`)."}, "enrichments": {"type": "array", "collectionFormat": "csv", "items": {"type": "string"}, "description": "The parameter defines an enrichment or enrichments (e.g., `enrichment=enrichment1&enrichment=enrichment2&enrichment=enrichment3`) you want to apply to the results.\n\nAvailable values: `domains_service`, `emails_validator_service`, `disposable_email_checker`, `whatsapp_checker`, `imessage_checker`, `phones_enricher_service`, `trustpilot_service`, `company_insights_service`, etc.\n\nUse `&enrichment=domains_service&enrichment=emails_validator_service` to enrich data with Emails & Contacts Scraper (domains_service), and Email Address Verifier (emails_validator_service).\n\nIt increases the time of the response."}, "tags": {"type": "array", "collectionFormat": "csv", "items": {"type": "string"}} }, "example": {"service_name":"google_maps_service_v2","queries":[],"enrich":false,"settings":{"output_extension":"xlsx","output_columns":[]},"tags":["restaurant +1"],"enrichments":["domains_service","company_insights_service"],"categories":["restaurant","dentist"],"locations":["SE>Stockholm"],"language":"en","region":"SE","limit":0,"organizationsPerQueryLimit":500,"filters":[],"exactMatch":false,"useZipCodes":true,"dropDuplicates":true,"dropEmailDuplicates":false,"ignoreWithoutEmails":false,"UISettings":{"isCustomQueries":false,"isCustomCategories":false,"isCustomLocations":false},"enrichLocations":true} } } } }, "responses": { "200": { "description": "Task created.", "content": { "application/json": { "example": {"id": "your-task-id"} } } }, "401": {"$ref": "#/components/schemas/responses/401"} } } }, "/tasks-validate" : { "post": { "summary": "Validate Task", "description": "Allows you to validate and estimate UI tasks.", "tags": [ "Platform & Dashboard" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "service_name": {"type": "string", "description": "ID of the service you want to use (e.g., `google_maps_service_v2`, `google_maps_reviews_service_v3`)."}, "queries": {"type": "array", "collectionFormat": "csv", "items": {"type": "string"}, "description": "Queries to search for (e.g., `restaurants ny usa`, `bars ny usa`)."}, "enrichments": {"type": "array", "collectionFormat": "csv", "items": {"type": "string"}, "description": "The parameter defines an enrichment or enrichments (e.g., `enrichment=enrichment1&enrichment=enrichment2&enrichment=enrichment3`) you want to apply to the results.\n\nAvailable values: `domains_service`, `emails_validator_service`, `disposable_email_checker`, `whatsapp_checker`, `imessage_checker`, `phones_enricher_service`, `trustpilot_service`, `company_insights_service`, etc.\n\nUse `&enrichment=domains_service&enrichment=emails_validator_service` to enrich data with Emails & Contacts Scraper (domains_service), and Email Address Verifier (emails_validator_service).\n\nIt increases the time of the response."}, "tags": {"type": "array", "collectionFormat": "csv", "items": {"type": "string"}} }, "example": {"service_name":"google_maps_service_v2","queries":[],"enrich":false,"settings":{"output_extension":"xlsx","output_columns":[]},"tags":["restaurant +1"],"enrichments":["domains_service","company_insights_service"],"categories":["restaurant","dentist"],"locations":["SE>Stockholm"],"language":"en","region":"SE","limit":0,"organizationsPerQueryLimit":500,"filters":[],"exactMatch":false,"useZipCodes":true,"dropDuplicates":true,"dropEmailDuplicates":false,"ignoreWithoutEmails":false,"UISettings":{"isCustomQueries":false,"isCustomCategories":false,"isCustomLocations":false},"enrichLocations":true} } } } }, "responses": { "200": { "description": "Task validation status.", "content": { "application/json": { "example": {} } } }, "401": {"$ref": "#/components/schemas/responses/401"} } } }, "/tasks/{taskId}" : { "get": { "summary": "Get Task", "description": "Fetch user task.", "tags": [ "Platform & Dashboard" ], "parameters": [ { "in": "path", "name": "taskId", "required": true, "description": "Task ID. Example: `20211211132758c8e9`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "User task.", "content": { "application/json": { "example": {"metadata":{"service_name":"google_maps_service_v2","queries":["bars ny usa","restaurants ny usa"]},"updated":"2022-02-08T20:51:17.402668","user_id":"YOUR_USER_ID","status":"SUCCESS","created":"2022-02-08T20:49:06.879078","queue_task_id":"2b9aa187-281a-4d4e-a4c6-fbe941aaac34","results":[{"product_name":"Google Maps Data","file_url":"LINK_TO_RESULTS","quantity":509.0},{"product_name":"Domains","quantity":509.0}],"id":"YOUR_TASK_ID"} } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/tasks/YOUR_TASK_ID\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] }, "put": { "summary": "Restart Task", "description": "Allows you to recreate tasks.", "tags": [ "Platform & Dashboard" ], "parameters": [ { "in": "path", "name": "taskId", "required": true, "description": "Task ID. Example: `20211211132758c8e9`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Task restarted.", "content": { "application/json": { "example": "Task restarted" } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X PUT \"https://api.outscraper.cloud/tasks/your-task-id\"" } ] }, "delete": { "summary": "Terminate Task", "description": "Allows you to terminate created tasks.", "tags": [ "Platform & Dashboard" ], "parameters": [ { "in": "path", "name": "taskId", "required": true, "description": "Task ID. Example: `20211211132758c8e9`", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Task removed.", "content": { "application/json": { "example": "Task removed" } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X DELETE \"https://api.outscraper.cloud/tasks/your-task-id\"" } ] } }, "/profile/balance" : { "get": { "summary": "Get Balance", "description": "Fetch user balance information.", "tags": [ "Platform & Dashboard" ], "responses": { "200": { "description": "Profile Balance.", "content": { "application/json": { "example": {"balance":1905.01,"account_status":"valid","upcoming_invoice":{"amount_due":0.0,"applied_balance":0.0,"total":0.0,"subtotal":0.0,"currency":"usd","total_discount":0.0,"period_start":1654784241,"period_end":1657376241,"collection_method":"charge_automatically","products_lines":[{"product_name":"Google Maps Data","unit":"place","quantity":382,"amount":0.0,"lines":[{"quantity":382,"amount":0.0,"currency":"usd","unit_price":"$0.00"}]},{"product_name":"Domains","unit":"domain","quantity":316,"amount":0.0,"lines":[{"quantity":316,"amount":0.0,"currency":"usd","unit_price":"$0.00"}]}],"subscription_id":"sub_ID"},"coupon":{},"id":"cus_ID"} } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/profile/balance\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/invoices" : { "get": { "summary": "Get Invoices", "description": "Fetch user invoices.", "tags": [ "Platform & Dashboard" ], "parameters": [ { "in": "path", "name": "lastId", "required": false, "description": "Last invoice ID. Used for pagination.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "User invoices.", "content": { "application/json": { "example": {"items": [], "has_more": false} } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/invoices\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/webhook-calls" : { "get": { "summary": "Failed Webhook Calls", "description": "Fetch the latest 100 failed webhook calls during the last 24 hours", "tags": [ "Platform & Dashboard" ], "responses": { "200": { "description": "Failed Webhooks.", "content": { "application/json": { "example": [{"status":"Status code: 404","date":1722949581}] } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/webhook-calls\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } }, "/statistics/status" : { "get": { "summary": "Get Services Status", "description": "Fetch the current status of services and incidents.", "tags": [ "Platform & Dashboard" ], "responses": { "200": { "description": "Services Status.", "content": { "application/json": { "example": [{"healthy": true, "incident": null, "monitors_down": []}] } } } }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/statistics/status\"" } ] } }, "/locations" : { "get": { "summary": "Get Country Locations", "description": "Fetch country locations that you can use to search on Google Maps.", "tags": [ "Platform & Dashboard" ], "responses": { "200": { "description": "Country Locations.", "content": { "application/json": { "example": {"items":[{"title":"Abruzzi","value":"IT>Abruzzi","children": []}], "supports_zip_codes":true} } } }, "401": {"$ref": "#/components/schemas/responses/401"} }, "x-codeSamples": [ { "lang": "cURL", "source": "curl -X GET \"https://api.outscraper.cloud/locations?country=IT\" -H \"X-API-KEY: YOUR-API-KEY\"" } ] } } } }