{"id":16184625,"url":"https://github.com/rmariuzzo/google-images-url","last_synced_at":"2026-01-20T00:37:47.946Z","repository":{"id":57252177,"uuid":"88103548","full_name":"rmariuzzo/google-images-url","owner":"rmariuzzo","description":"🔗 URL generator for Google Images","archived":false,"fork":false,"pushed_at":"2017-04-13T17:01:21.000Z","size":43,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-30T03:21:46.807Z","etag":null,"topics":["google-images","url-parser"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rmariuzzo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-12T22:55:02.000Z","updated_at":"2017-04-15T05:41:32.000Z","dependencies_parsed_at":"2022-09-17T20:02:39.080Z","dependency_job_id":null,"html_url":"https://github.com/rmariuzzo/google-images-url","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmariuzzo%2Fgoogle-images-url","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmariuzzo%2Fgoogle-images-url/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmariuzzo%2Fgoogle-images-url/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmariuzzo%2Fgoogle-images-url/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rmariuzzo","download_url":"https://codeload.github.com/rmariuzzo/google-images-url/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247713305,"owners_count":20983683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google-images","url-parser"],"created_at":"2024-10-10T07:10:51.448Z","updated_at":"2026-01-20T00:37:47.916Z","avatar_url":"https://github.com/rmariuzzo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Google Images URL\n🔗 URL generator for Google images\n\n## Installation\n\n```shell\nnpm install google-images-url\n# or\nyarn add google-images-url\n```\n\n### Usage\n\n```js\nimport GoogleImagesUrl from 'GoogleImagesUrl'\n\nGoogleImagesUrl.create('cute cats', { size: 'large' })\n// \u003e https://www.google.com/search?q=cute%20cats\u0026tbs=isz:l,qdr:a\u0026tbm=isch\n```\n\n### API\n\n```js\nGoogleImagesUrl.create(query, options)\n```\n\n - `query` - The term used for the search.\n - `options` - An object containing options to customize the Google Images URL.\n\n#### `query`\n\nThe query is the term used for the search. It should be a string.\n\n#### `options`\n\nThe options parameter is an object containing different values:\n\n - **`size`** – `{String|Object}` The size of the images. If a string is provided then it should be one of the following values: `icon`, `medium` or `large`. If an object is provided it should contains `width` and `height` properties.\n\n - **`color`** - `{String}` The color of the images. The string should be one of the following values: `orange`, `yellow`, `green`, `teal`, `blue`, `purple`, `pink`, `white`, `gray`, `black` or `brown`.\n\n - **`types`** - `{String}` The type of images. The string should be one of the following values: `face`, `photo`, `clipart`, `lineart` or `animated`.\n\n - **`showSizes`** - `{Boolean}` Show images sizes in results. If `true` show images sizes in results, otherwise no.\n\n - **`time`** - `{String|Object}` The time range of the images. If a string is provided it should be one of the following values: `anytime`, `second`, `minute`, `hour`, `day`, `week`, `month` or `year`. If an object is provided it should contains `from` and `to` properties. The values for these properties should be a string value representing a date in the format: `mm/dd/yyyy`.\n\n - **`sortBy`** - `{String}` The sorting algorithm. The string should be one of the following values: `date` or `relevance`.\n\n## Tests\n\n```shell\nnpm test\n# or\nyarn test\n```\n\n#### Appreciations\n\nThanks to Theodor Stenevang Klemming for [his article](https://stenevang.wordpress.com/2013/02/22/google-advanced-power-search-url-request-parameters/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmariuzzo%2Fgoogle-images-url","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frmariuzzo%2Fgoogle-images-url","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmariuzzo%2Fgoogle-images-url/lists"}