POST
/
api
/
v2
/
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>",
  "location": "<string>",
  "uule": "<string>",
  "google_domain": "<string>",
  "gl": "<string>",
  "hl": "<string>",
  "page": 123,
  "num": 123
}'
{
    "search_parameters": {
        "q": "site:linkedin.com Bill Gates",
        "gl": "en",
        "hl": "us",
        "num": 10,
        "page": 1,
        "engine": "google",
        "google_domain": "google.com"
    },
    "organic_results": [
        {
            "link": "https://www.linkedin.com/in/williamhgates",
            "title": "Bill Gates - Bill & Melinda Gates Foundation",
            "domain": "www.linkedin.com",
            "snippet": "Chair of the Bill & Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder… · Experience: Bill & Melinda Gates Foundation · Education: Harvard ...",
            "position": 1,
            "displayed_link": "36.6M+ followers",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        },
        {
            "link": "https://www.linkedin.com/today/author/williamhgates",
            "title": "Bill Gates",
            "domain": "www.linkedin.com",
            "snippet": "Check out professional insights posted by Bill Gates, Chair, Gates Foundation and Founder, Breakthrough Energy.",
            "position": 2,
            "displayed_link": "https://www.linkedin.com › today › author › williamhgates",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_im-lucky-that-my-work-gives-me-insight-into-activity-7143045033464651776-lEeh",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "I think for the world, what people will remember is the instability, wars in the Middle East and continuing in Ukraine and other places.",
            "position": 3,
            "displayed_link": "4.6K+ reactions  ·  11 months ago",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_wherever-your-road-takes-you-this-summeri-activity-7198765186084671489-chBL",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "Bill Gates is looking very very young. Ladies and gentlemen, please welcome to the newest young man on planet earth. He is Brilliant, Gallant, ...",
            "position": 4,
            "displayed_link": "3.6K+ reactions  ·  6 months ago",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_im-proud-that-the-gates-foundation-is-opening-activity-7254912034612379648-eeS9",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "I'm proud that the Gates Foundation is opening a new office in Dakar, Senegal. Africa's development progress is a priority for the ...",
            "position": 5,
            "displayed_link": "3K+ reactions  ·  1 month ago",
            "snippet_matched": [
                "Gates"
            ]
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_thanks-to-brilliant-minds-big-ideas-and-activity-7212451370350567424-h-7A",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "Thanks to brilliant minds, big ideas, and bold investments, transformative climate tech has arrived. Now it's time to commit our support to get ...",
            "position": 6,
            "displayed_link": "4.9K+ reactions  ·  4 months ago",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_the-age-of-ai-has-begun-activity-7043993848976482304-jE-z",
            "title": "Bill Gates on LinkedIn: The Age of AI has begun",
            "domain": "www.linkedin.com",
            "snippet": "Train an artificial intelligence to pass an Advanced Placement biology exam. Make it capable of answering questions that it hasn't been specifically trained ...",
            "position": 7,
            "displayed_link": "61.2K+ reactions  ·  1 year ago",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/pulse/bill-gates-went-back-study-a-level-science-here-why-matters-likinyo",
            "title": "Bill Gates went back to study A-level science, here is why it ...",
            "domain": "www.linkedin.com",
            "snippet": "After retiring from Microsoft and transitioning to a full-time role at Gates Foundation he found it important to go back to learning about the basics of ...",
            "position": 8,
            "displayed_link": "10+ reactions  ·  1 year ago",
            "snippet_matched": [
                "Gates"
            ]
        },
        {
            "link": "https://fr.linkedin.com/company/bill-&-melinda-gates-foundation/jobs",
            "title": "Bill & Melinda Gates Foundation : offres d'emploi",
            "domain": "fr.linkedin.com",
            "snippet": "Offres d'emploi chez Bill & Melinda Gates Foundation · Senior program Officer, Regulatory Affairs · Senior Program Officer, Pharmacometrics · Senior Program ...",
            "position": 9,
            "displayed_link": "https://fr.linkedin.com › jobs",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        }
    ],
    "search_information": {
        "error": "Some results may have been removed under data protection law in Europe. Learn more",
        "total_results": 3890000,
        "time_taken_displayed": 0.14
    }
    "pagination": {
        "next": 2,
        "current": 1,
        "other_pages": [
            2,
            3,
            4,
            5,
            6,
            7,
            8,
            9,
            10
        ],
        "has_next_page": true
    },
}
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:.

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

google_domain
string

Parameter defines the Google domain to use. It defaults to google.com. Head to the Google domains page for a full list of supported Google domains.

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

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

{
    "search_parameters": {
        "q": "site:linkedin.com Bill Gates",
        "gl": "en",
        "hl": "us",
        "num": 10,
        "page": 1,
        "engine": "google",
        "google_domain": "google.com"
    },
    "organic_results": [
        {
            "link": "https://www.linkedin.com/in/williamhgates",
            "title": "Bill Gates - Bill & Melinda Gates Foundation",
            "domain": "www.linkedin.com",
            "snippet": "Chair of the Bill & Melinda Gates Foundation. Founder of Breakthrough Energy. Co-founder… · Experience: Bill & Melinda Gates Foundation · Education: Harvard ...",
            "position": 1,
            "displayed_link": "36.6M+ followers",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        },
        {
            "link": "https://www.linkedin.com/today/author/williamhgates",
            "title": "Bill Gates",
            "domain": "www.linkedin.com",
            "snippet": "Check out professional insights posted by Bill Gates, Chair, Gates Foundation and Founder, Breakthrough Energy.",
            "position": 2,
            "displayed_link": "https://www.linkedin.com › today › author › williamhgates",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_im-lucky-that-my-work-gives-me-insight-into-activity-7143045033464651776-lEeh",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "I think for the world, what people will remember is the instability, wars in the Middle East and continuing in Ukraine and other places.",
            "position": 3,
            "displayed_link": "4.6K+ reactions  ·  11 months ago",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_wherever-your-road-takes-you-this-summeri-activity-7198765186084671489-chBL",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "Bill Gates is looking very very young. Ladies and gentlemen, please welcome to the newest young man on planet earth. He is Brilliant, Gallant, ...",
            "position": 4,
            "displayed_link": "3.6K+ reactions  ·  6 months ago",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_im-proud-that-the-gates-foundation-is-opening-activity-7254912034612379648-eeS9",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "I'm proud that the Gates Foundation is opening a new office in Dakar, Senegal. Africa's development progress is a priority for the ...",
            "position": 5,
            "displayed_link": "3K+ reactions  ·  1 month ago",
            "snippet_matched": [
                "Gates"
            ]
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_thanks-to-brilliant-minds-big-ideas-and-activity-7212451370350567424-h-7A",
            "title": "Bill Gates' Post",
            "domain": "www.linkedin.com",
            "snippet": "Thanks to brilliant minds, big ideas, and bold investments, transformative climate tech has arrived. Now it's time to commit our support to get ...",
            "position": 6,
            "displayed_link": "4.9K+ reactions  ·  4 months ago",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/posts/williamhgates_the-age-of-ai-has-begun-activity-7043993848976482304-jE-z",
            "title": "Bill Gates on LinkedIn: The Age of AI has begun",
            "domain": "www.linkedin.com",
            "snippet": "Train an artificial intelligence to pass an Advanced Placement biology exam. Make it capable of answering questions that it hasn't been specifically trained ...",
            "position": 7,
            "displayed_link": "61.2K+ reactions  ·  1 year ago",
            "snippet_matched": []
        },
        {
            "link": "https://www.linkedin.com/pulse/bill-gates-went-back-study-a-level-science-here-why-matters-likinyo",
            "title": "Bill Gates went back to study A-level science, here is why it ...",
            "domain": "www.linkedin.com",
            "snippet": "After retiring from Microsoft and transitioning to a full-time role at Gates Foundation he found it important to go back to learning about the basics of ...",
            "position": 8,
            "displayed_link": "10+ reactions  ·  1 year ago",
            "snippet_matched": [
                "Gates"
            ]
        },
        {
            "link": "https://fr.linkedin.com/company/bill-&-melinda-gates-foundation/jobs",
            "title": "Bill & Melinda Gates Foundation : offres d'emploi",
            "domain": "fr.linkedin.com",
            "snippet": "Offres d'emploi chez Bill & Melinda Gates Foundation · Senior program Officer, Regulatory Affairs · Senior Program Officer, Pharmacometrics · Senior Program ...",
            "position": 9,
            "displayed_link": "https://fr.linkedin.com › jobs",
            "snippet_matched": [
                "Gates",
                "Bill"
            ]
        }
    ],
    "search_information": {
        "error": "Some results may have been removed under data protection law in Europe. Learn more",
        "total_results": 3890000,
        "time_taken_displayed": 0.14
    }
    "pagination": {
        "next": 2,
        "current": 1,
        "other_pages": [
            2,
            3,
            4,
            5,
            6,
            7,
            8,
            9,
            10
        ],
        "has_next_page": true
    },
}