|
1 | 1 | <p align="center"> |
2 | | - <img src="https://justserpapi.com/logo/whiteBgColor.webp" alt="JustSerpAPI Logo" width="200"> |
| 2 | + <a href="https://justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_logo"> |
| 3 | + <img src="https://justserpapi.com/logo/whiteBgColor.webp" alt="JustSerpAPI Logo" width="200"> |
| 4 | + </a> |
3 | 5 | </p> |
4 | 6 |
|
5 | 7 | <h1 align="center">JustSerpAPI Python SDK</h1> |
|
11 | 13 | <a href="https://pypi.org/project/justserpapi/"> |
12 | 14 | <img src="https://img.shields.io/pypi/pyversions/justserpapi?style=flat-square" alt="Python Versions"> |
13 | 15 | </a> |
14 | | - <a href="https://docs.justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme"> |
| 16 | + <a href="https://docs.justserpapi.com"> |
15 | 17 | <img src="https://img.shields.io/badge/docs-latest-brightgreen?style=flat-square" alt="Documentation"> |
16 | 18 | </a> |
17 | 19 | <a href="LICENSE"> |
18 | 20 | <img src="https://img.shields.io/badge/license-MIT-orange?style=flat-square" alt="License"> |
19 | 21 | </a> |
20 | 22 | </p> |
21 | 23 |
|
22 | | -OpenAPI-driven Python SDK for JustSerpAPI with a stable high-level `Client` as the public entrypoint. |
| 24 | +OpenAPI-driven Python SDK for [JustSerpAPI](https://justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme) with a stable high-level `Client` as the public entrypoint. |
| 25 | + |
| 26 | +## Platform Overview |
| 27 | + |
| 28 | +The documentation center helps you browse endpoint health, versioned API paths, request parameters, and SERP-specific usage notes. |
23 | 29 |
|
24 | | -Official Python SDK for [JustSerpAPI](https://justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme). |
| 30 | +[](https://docs.justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_docs_image) |
25 | 31 |
|
26 | | -Use this SDK to access JustSerpAPI from Python and fetch structured Google search results without building raw HTTP requests by hand. |
| 32 | +The console provides API key management, subscription status, credit visibility, request logs, usage trends, and credit consumption analytics. |
27 | 33 |
|
28 | | -Get your API key, product docs, and pricing at [justserpapi.com](https://justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme). |
| 34 | +[](https://dashboard.justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_dashboard_image) |
29 | 35 |
|
30 | 36 | ## Installation |
31 | 37 |
|
@@ -136,6 +142,107 @@ git push origin vX.Y.Z |
136 | 142 | - If `openapi/justserpapi.openapi.json` is committed, its `info.version` must match the tag and package version |
137 | 143 | - GitHub Actions publishes tagged releases to PyPI through Trusted Publishing |
138 | 144 |
|
| 145 | +## Service Overview |
| 146 | + |
| 147 | +The API list below is generated from OpenAPI and shows the current public API categories and endpoint names. See the [online API documentation](https://docs.justserpapi.com/?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) for full request and response details. |
| 148 | + |
| 149 | +<!-- API_LIST_START --> |
| 150 | + |
| 151 | +### Google Search API |
| 152 | + |
| 153 | +- [Search API](https://docs.justserpapi.com/api/v1/google/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 154 | +- [Light Search API](https://docs.justserpapi.com/api/v1/google/search/light?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 155 | +- [Mobile Search API](https://docs.justserpapi.com/api/v1/google/search/mobile?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 156 | + |
| 157 | +### Google AI Mode API |
| 158 | + |
| 159 | +- [AI Mode API](https://docs.justserpapi.com/api/v1/google/ai-mode?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 160 | + |
| 161 | +### Google AI Overview API |
| 162 | + |
| 163 | +- [AI Overview API](https://docs.justserpapi.com/api/v1/google/ai-overview?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 164 | + |
| 165 | +### Google Maps API |
| 166 | + |
| 167 | +- [Maps Search API](https://docs.justserpapi.com/api/v1/google/maps/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 168 | +- [Maps Posts API](https://docs.justserpapi.com/api/v1/google/maps/posts?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 169 | +- [Maps Photos API](https://docs.justserpapi.com/api/v1/google/maps/photos?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 170 | +- [Maps Reviews API](https://docs.justserpapi.com/api/v1/google/maps/reviews?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 171 | +- [Maps Place Details API](https://docs.justserpapi.com/api/v1/google/maps/places?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 172 | + |
| 173 | +### Google Images API |
| 174 | + |
| 175 | +- [Images Search API](https://docs.justserpapi.com/api/v1/google/images/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 176 | + |
| 177 | +### Google News API |
| 178 | + |
| 179 | +- [News Search API](https://docs.justserpapi.com/api/v1/google/news/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 180 | + |
| 181 | +### Google Videos API |
| 182 | + |
| 183 | +- [Videos Search API](https://docs.justserpapi.com/api/v1/google/videos/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 184 | + |
| 185 | +### Google Shorts API |
| 186 | + |
| 187 | +- [Shorts Search API](https://docs.justserpapi.com/api/v1/google/shorts/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 188 | + |
| 189 | +### Google Finance API |
| 190 | + |
| 191 | +- [Finance Search API](https://docs.justserpapi.com/api/v1/google/finance/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 192 | + |
| 193 | +### Google Trends API |
| 194 | + |
| 195 | +- [Google Trends Search API](https://docs.justserpapi.com/api/v1/google/trends/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 196 | +- [Google Trends Autocomplete API](https://docs.justserpapi.com/api/v1/google/trends/autocomplete?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 197 | +- [Google Trends Trending Now API](https://docs.justserpapi.com/api/v1/google/trends/trending-now?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 198 | + |
| 199 | +### Google Shopping API |
| 200 | + |
| 201 | +- [Shopping Search API](https://docs.justserpapi.com/api/v1/google/shopping/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 202 | + |
| 203 | +### Google Immersive Product API |
| 204 | + |
| 205 | +- [Immersive Product API](https://docs.justserpapi.com/api/v1/google/immersive/product?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 206 | + |
| 207 | +### Google Autocomplete API |
| 208 | + |
| 209 | +- [Autocomplete API](https://docs.justserpapi.com/api/v1/google/autocomplete?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 210 | + |
| 211 | +### Google Scholar API |
| 212 | + |
| 213 | +- [Google Scholar Search API](https://docs.justserpapi.com/api/v1/google/scholar/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 214 | +- [Google Scholar Author API](https://docs.justserpapi.com/api/v1/google/scholar/author?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 215 | +- [Google Scholar Cite API](https://docs.justserpapi.com/api/v1/google/scholar/cite/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 216 | + |
| 217 | +### Google Lens API |
| 218 | + |
| 219 | +- [Lens API](https://docs.justserpapi.com/api/v1/google/lens?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 220 | + |
| 221 | +### Google Jobs API |
| 222 | + |
| 223 | +- [Jobs Search API](https://docs.justserpapi.com/api/v1/google/jobs/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 224 | + |
| 225 | +### Google Local API |
| 226 | + |
| 227 | +- [Local Search API](https://docs.justserpapi.com/api/v1/google/local/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 228 | + |
| 229 | +### Google Patents API |
| 230 | + |
| 231 | +- [Google Patents Search API](https://docs.justserpapi.com/api/v1/google/patents/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 232 | +- [Google Patents Details API](https://docs.justserpapi.com/api/v1/google/patents/details?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 233 | + |
| 234 | +### Google Hotels API |
| 235 | + |
| 236 | +- [Hotels Search API](https://docs.justserpapi.com/api/v1/google/hotels/search?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 237 | + |
| 238 | +### Web API |
| 239 | + |
| 240 | +- [Crawl Webpage (HTML)](https://docs.justserpapi.com/api/v1/web/html?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 241 | +- [Crawl Webpage (Rendered HTML)](https://docs.justserpapi.com/api/v1/web/rendered-html?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 242 | +- [Crawl Webpage (Markdown)](https://docs.justserpapi.com/api/v1/web/markdown?utm_source=github.com&utm_medium=referral&utm_campaign=justserpapi_justserpapi_python&utm_content=repo_readme_api_list) |
| 243 | + |
| 244 | +<!-- API_LIST_END --> |
| 245 | + |
139 | 246 | ## License |
140 | 247 |
|
141 | 248 | Distributed under the MIT License. See `LICENSE` for more information. |
0 commit comments