Skip to main content
POST
/
api
/
v2
/
google
/
search
Google Search
curl --request POST \
  --url https://piloterr.com/api/v2/google/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "query": "<string>",
  "tbs": "<string>",
  "location": "<string>",
  "uule": "<string>",
  "gl": "<string>",
  "hl": "<string>",
  "page": 123,
  "num": 123
}'
{
    "pagination": {
        "next": 2,
        "current": 1,
        "other_pages": [
            2,
            3,
            4,
            5,
            6,
            7,
            8,
            9,
            10
        ],
        "has_next_page": true
    },
    "knowledge_graph": {
        "type": "Aircraft manufacturing commercial company",
        "title": "Airbus SE",
        "website": "https://www.airbus.com/en",
        "attributes": {
            "Owner": "SOGEPA (French Government): 10.9%; GZBV(German Government): 10.8%; SEPI (Spanish Government): 4.1%;",
            "Founded": "December 18, 1970",
            "Founder": "Roger Béteille",
            "Revenue": "65.45 billion EUR (2023)",
            "Divisions": "Defence and Space; Helicopters",
            "Predecessor": "Aérospatiale, EADS CASA, DASA, Matra",
            "Headquarters": "Leiden, Netherlands"
        },
        "description": "Airbus SE is a European aerospace corporation. The company's primary business is the design and manufacturing of commercial aircraft but it also has separate defence and space and helicopter divisions.",
        "description_link": "https://en.wikipedia.org/wiki/Airbus",
        "description_source": "Wikipedia"
    },
    "organic_results": [
        {
            "link": "https://www.airbus.com/en",
            "title": "Airbus: Pioneering sustainable aerospace",
            "domain": "www.airbus.com",
            "source": "Airbus",
            "snippet": "Airbus designs, manufactures and delivers industry-leading commercial aircraft, helicopters, military transports, satellites, launchers and more.",
            "position": 1,
            "displayed_link": "https://www.airbus.com › ...",
            "snippet_matched": [
                "Airbus"
            ]
        },
        {
            "link": "https://en.wikipedia.org/wiki/Airbus",
            "title": "Airbus",
            "domain": "en.wikipedia.org",
            "source": "Wikipedia",
            "snippet": "The company's primary business is the design and manufacturing of commercial aircraft but it also has separate defence and space and helicopter divisions.",
            "position": 2,
            "displayed_link": "https://en.wikipedia.org › wiki › Airbus",
            "snippet_matched": [
                "Company"
            ]
        },
        {
            "link": "https://www.facebook.com/simpleflyingnews/posts/airbus-ceo-company-on-track-to-meet-2025-delivery-goals-despite-engine-shortage-/1277829514361844/",
            "title": "10+ reactions",
            "domain": "www.facebook.com",
            "source": "Airbus",
            "snippet": "Aviation news & insight",
            "position": 3,
            "displayed_link": "www.facebook.com",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/company/airbusgroup/",
            "title": "Airbus",
            "domain": "www.linkedin.com",
            "source": "LinkedIn · Airbus",
            "snippet": "In commercial aircraft, Airbus designs and manufactures modern and fuel-efficient airliners and associated services. Airbus is also a European leader in space ...",
            "position": 4,
            "displayed_link": "2.6M+ followers",
            "snippet_matched": [
                "Airbus"
            ]
        },
        {
            "link": "https://www.globaldata.com/company-profile/airbus-se/",
            "title": "Airbus SE Company Profile - Overview - GlobalData",
            "domain": "www.globaldata.com",
            "source": "globaldata.com",
            "snippet": "Airbus SE (Airbus) is a provider of aeronautics, defense, and space-related services. The company manufactures commercial aircraft, helicopters, passenger ...",
            "position": 5,
            "displayed_link": "https://www.globaldata.com › All Companies",
            "snippet_matched": [
                "Airbus",
                "Company"
            ]
        },
        {
            "link": "https://en.wikipedia.org/wiki/Airbus_Group",
            "title": "Airbus Group",
            "domain": "en.wikipedia.org",
            "source": "Wikipedia",
            "snippet": "Airbus Group, Inc. (formerly EADS North America) represents the North American activities of European [4] multinational aerospace company Airbus.",
            "position": 6,
            "displayed_link": "https://en.wikipedia.org › wiki › Airbus_Group",
            "snippet_matched": [
                "Airbus",
                "Company"
            ]
        }
    ],
    "related_searches": [
        {
            "query": "Airbus headquarters"
        },
        {
            "query": "Boeing"
        },
        {
            "query": "Airbus owner"
        },
        {
            "query": "Airbus airlines"
        },
        {
            "query": "Airbus net worth"
        },
        {
            "query": "Airbus company which country"
        },
        {
            "query": "Airbus CEO"
        },
        {
            "query": "Airbus vs Boeing"
        }
    ],
    "search_parameters": {
        "q": "Airbus Company",
        "gl": "us",
        "hl": "en",
        "page": 1,
        "uule": null,
        "engine": "google",
        "location": null
    },
    "search_information": {
        "total_results": null,
        "time_taken_displayed": null
    }
}
​
x-api-key
string
required
This parameter specifies the private key you’ll need for Piloterr access.

​
Body

​
Search Query

​
query
string
required
Parameter defines the query you want to search. You can use anything that you would use in a regular Google search. e.g. inurl:, site:, intitle:.

​
Advanced Filters

​
tbs
string
Optional parameter that defines advanced search filters not possible via the regular query field. Common time range filters:
  • qdr:h → last hour
  • qdr:d → last day
  • qdr:w → last week
  • qdr:m → last month
  • qdr:y → last year

​
Geographic Location

​
location
string
Parameter defines from where you want the search to originate. If several locations match the location requested, we’ll pick the most popular one. You can use formats like New York, NY, Paris, France, Tokyo, Japan. It is recommended to specify location at the city level to simulate a real user’s search. If location is omitted, the search may take on the location of the proxy.Head to the Google Locations API if you need more precise control. Note: The location and uule parameters cannot be used together.
​
uule
string
Parameter is the Google encoded location you want to use for the search. Note: uule and location parameters cannot be used together.

​
Localization

​
gl
string
Parameter defines the country to use for the Google search. It’s a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries or the Countries API for a more precise search.
​
hl
string
Parameter defines the language to use for the Google search. It’s a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages or the Languages API for a more precise search.

​
Pagination

​
page
integer
Parameter defines the result offset. It skips the given number of results. It’s used for pagination.
​
num
integer
deprecated
Parameter defines the maximum number of results to return. (e.g., 10 (default) returns 10 results, 40 returns 40 results, and 100 returns 100 results).

​
Response

​
Google Search
object
{
    "pagination": {
        "next": 2,
        "current": 1,
        "other_pages": [
            2,
            3,
            4,
            5,
            6,
            7,
            8,
            9,
            10
        ],
        "has_next_page": true
    },
    "knowledge_graph": {
        "type": "Aircraft manufacturing commercial company",
        "title": "Airbus SE",
        "website": "https://www.airbus.com/en",
        "attributes": {
            "Owner": "SOGEPA (French Government): 10.9%; GZBV(German Government): 10.8%; SEPI (Spanish Government): 4.1%;",
            "Founded": "December 18, 1970",
            "Founder": "Roger Béteille",
            "Revenue": "65.45 billion EUR (2023)",
            "Divisions": "Defence and Space; Helicopters",
            "Predecessor": "Aérospatiale, EADS CASA, DASA, Matra",
            "Headquarters": "Leiden, Netherlands"
        },
        "description": "Airbus SE is a European aerospace corporation. The company's primary business is the design and manufacturing of commercial aircraft but it also has separate defence and space and helicopter divisions.",
        "description_link": "https://en.wikipedia.org/wiki/Airbus",
        "description_source": "Wikipedia"
    },
    "organic_results": [
        {
            "link": "https://www.airbus.com/en",
            "title": "Airbus: Pioneering sustainable aerospace",
            "domain": "www.airbus.com",
            "source": "Airbus",
            "snippet": "Airbus designs, manufactures and delivers industry-leading commercial aircraft, helicopters, military transports, satellites, launchers and more.",
            "position": 1,
            "displayed_link": "https://www.airbus.com › ...",
            "snippet_matched": [
                "Airbus"
            ]
        },
        {
            "link": "https://en.wikipedia.org/wiki/Airbus",
            "title": "Airbus",
            "domain": "en.wikipedia.org",
            "source": "Wikipedia",
            "snippet": "The company's primary business is the design and manufacturing of commercial aircraft but it also has separate defence and space and helicopter divisions.",
            "position": 2,
            "displayed_link": "https://en.wikipedia.org › wiki › Airbus",
            "snippet_matched": [
                "Company"
            ]
        },
        {
            "link": "https://www.facebook.com/simpleflyingnews/posts/airbus-ceo-company-on-track-to-meet-2025-delivery-goals-despite-engine-shortage-/1277829514361844/",
            "title": "10+ reactions",
            "domain": "www.facebook.com",
            "source": "Airbus",
            "snippet": "Aviation news & insight",
            "position": 3,
            "displayed_link": "www.facebook.com",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/company/airbusgroup/",
            "title": "Airbus",
            "domain": "www.linkedin.com",
            "source": "LinkedIn · Airbus",
            "snippet": "In commercial aircraft, Airbus designs and manufactures modern and fuel-efficient airliners and associated services. Airbus is also a European leader in space ...",
            "position": 4,
            "displayed_link": "2.6M+ followers",
            "snippet_matched": [
                "Airbus"
            ]
        },
        {
            "link": "https://www.globaldata.com/company-profile/airbus-se/",
            "title": "Airbus SE Company Profile - Overview - GlobalData",
            "domain": "www.globaldata.com",
            "source": "globaldata.com",
            "snippet": "Airbus SE (Airbus) is a provider of aeronautics, defense, and space-related services. The company manufactures commercial aircraft, helicopters, passenger ...",
            "position": 5,
            "displayed_link": "https://www.globaldata.com › All Companies",
            "snippet_matched": [
                "Airbus",
                "Company"
            ]
        },
        {
            "link": "https://en.wikipedia.org/wiki/Airbus_Group",
            "title": "Airbus Group",
            "domain": "en.wikipedia.org",
            "source": "Wikipedia",
            "snippet": "Airbus Group, Inc. (formerly EADS North America) represents the North American activities of European [4] multinational aerospace company Airbus.",
            "position": 6,
            "displayed_link": "https://en.wikipedia.org › wiki › Airbus_Group",
            "snippet_matched": [
                "Airbus",
                "Company"
            ]
        }
    ],
    "related_searches": [
        {
            "query": "Airbus headquarters"
        },
        {
            "query": "Boeing"
        },
        {
            "query": "Airbus owner"
        },
        {
            "query": "Airbus airlines"
        },
        {
            "query": "Airbus net worth"
        },
        {
            "query": "Airbus company which country"
        },
        {
            "query": "Airbus CEO"
        },
        {
            "query": "Airbus vs Boeing"
        }
    ],
    "search_parameters": {
        "q": "Airbus Company",
        "gl": "us",
        "hl": "en",
        "page": 1,
        "uule": null,
        "engine": "google",
        "location": null
    },
    "search_information": {
        "total_results": null,
        "time_taken_displayed": null
    }
}