{ "openapi": "3.0.3", "info": { "title": "Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor", "version": "3.0.0", "description": "Batch geocodes and validates Brazilian 8-digit postal codes (CEPs) via official Brazilian postal & IBGE registries. Extracts Latitude/Longitude, 7-digit IBGE city code (for NF-e/CT-e), state UF, neighborhood, and Last-Mile Delivery Scores (0-100).\n\n### Enterprise B2B Value Proposition (Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor)\n- **Target B2B Buyers:** eCommerce Checkout Flows, Last-Mile Delivery Routers, NF-e Issuers, and Retail Omni-Channel ERPs.\n- **Zero External API Keys Required:** Connects directly to authoritative government, regulatory, and financial primary registries with built-in retry/backoff and deterministic schema normalization.\n- **Quantitative Scoring & RAG Briefs:** Every record is enriched with a quantitative 0-100 risk/viability score and an LLM-ready Markdown executive brief (`Brazil CEP Geocoordinates & IBGE City Code Audited`).\n- **Backend Proxy Secret Injection:** RapidAPI Studio and Zyla API Hub inject `Authorization: Bearer ` invisibly at the proxy layer when forwarding synchronous calls to `https://api.apify.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items`.\n- **Marketplace Categories:** RapidAPI `Logistics` | Zyla API Hub `Logistics & Shipping`.\n- **Subscription Tiers (USD):** `BASIC` ($0.00/mo, 15 req/mo hard cap), `PRO` ($19.00/mo, 1,000 req/mo + $0.02/extra), `ULTRA` ($49.00/mo, 5,000 req/mo + $0.015/extra), `MEGA` ($149.00/mo, 25,000 req/mo + $0.010/extra).\n- **SEO Keywords:** brazil-cep-lookup, postal-geocoding, ibge-municipality-code, nfe-address-validator, last-mile-logistics, ddd-lookup, ecommerce-checkout.", "termsOfService": "https://jesleytassili-glitch.github.io/b2b-quant-mcp-n8n-suite/", "contact": { "name": "B2B Quant APIs (@b2b-quant-apis)", "email": "jesleytassili@gmail.com", "url": "https://apify.com/b2b-quant-apis/brazil-cep-geocoordinates-logistics-auditor" }, "license": { "name": "Commercial B2B API Subscription (RapidAPI & Zyla Hub)", "url": "https://apify.com/b2b-quant-apis/brazil-cep-geocoordinates-logistics-auditor" }, "x-category": "Logistics", "x-rapidapi-category": "Logistics", "x-zyla-category": "Logistics & Shipping", "x-seo-tags": [ "brazil-cep-lookup", "postal-geocoding", "ibge-municipality-code", "nfe-address-validator", "last-mile-logistics", "ddd-lookup", "ecommerce-checkout" ], "x-payout-destination": "Wise #890361113", "x-pricing-plans": { "BASIC": { "tier": "BASIC", "label": "Freemium Developer Trial", "monthlyPriceUsd": 0.0, "monthlyQuotaRequests": 15, "overagePricePerRequestUsd": 0.0, "hardLimit": true }, "PRO": { "tier": "PRO", "label": "Startup & RevOps Pipeline", "monthlyPriceUsd": 19.0, "monthlyQuotaRequests": 1000, "overagePricePerRequestUsd": 0.02, "hardLimit": false }, "ULTRA": { "tier": "ULTRA", "label": "Mid-Market Automation Cluster", "monthlyPriceUsd": 49.0, "monthlyQuotaRequests": 5000, "overagePricePerRequestUsd": 0.015, "hardLimit": false }, "MEGA": { "tier": "MEGA", "label": "Enterprise High-Throughput SLA", "monthlyPriceUsd": 149.0, "monthlyQuotaRequests": 25000, "overagePricePerRequestUsd": 0.01, "hardLimit": false } }, "x-code-snippets": { "cURL": "# Primary Synchronous Endpoint: https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\ncurl --request POST \\\n --url \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5}'", "Python": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nurl = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\"\npayload = {\n \"ceps\": \"01310100,20040002,30140071\",\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n", "Node.js": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nconst url = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" }, "x-primary-backend-url": "https://api.apify.com", "x-primary-backend-base-url": "https://api.apify.com", "x-apify-sync-endpoint": "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items", "x-apify-health-endpoint": "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor", "x-backend-secret-header": { "name": "Authorization", "valueTemplate": "Bearer ", "headerName": "Authorization", "headerValueTemplate": "Bearer ", "injectedByProxy": true, "hiddenFromSubscriber": true, "description": "Secret Header injected invisibly by RapidAPI Studio and Zyla API Hub proxy when calling https://api.apify.com." }, "x-openapi-spec-url": "https://jesleytassili-glitch.github.io/specs_openapi_31/brazil-cep-geocoordinates-logistics-auditor.json", "x-openapi-suite-spec-url": "https://jesleytassili-glitch.github.io/b2b-quant-mcp-n8n-suite/specs_openapi_31/brazil-cep-geocoordinates-logistics-auditor.json", "x-apis-json-url": "https://jesleytassili-glitch.github.io/apis.json", "x-github-release-tag": "v2.2.0" }, "externalDocs": { "description": "Official B2B Documentation & Schema Reference for Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor", "url": "https://jesleytassili-glitch.github.io/b2b-quant-mcp-n8n-suite/actors/brazil-cep-geocoordinates-logistics-auditor.html" }, "servers": [ { "url": "https://api.apify.com", "description": "Primary Apify Cloud Synchronous Execution Cluster (Real HTTP 200/201 POST & GET)" }, { "url": "https://api.apify.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items", "description": "Direct Apify Actor Synchronous Execution Endpoint (brazil-cep-geocoordinates-logistics-auditor)" }, { "url": "https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev", "description": "Anti-Bypass Stateless B2B Gateway (RapidAPI & Zyla Hub Proxy)" } ], "tags": [ { "name": "Logistics", "description": "RapidAPI Hub primary category: Logistics (Zyla Hub: Logistics & Shipping)" }, { "name": "brazil-cep-lookup", "description": "B2B SEO Search Tag: brazil-cep-lookup" }, { "name": "postal-geocoding", "description": "B2B SEO Search Tag: postal-geocoding" }, { "name": "ibge-municipality-code", "description": "B2B SEO Search Tag: ibge-municipality-code" }, { "name": "nfe-address-validator", "description": "B2B SEO Search Tag: nfe-address-validator" }, { "name": "last-mile-logistics", "description": "B2B SEO Search Tag: last-mile-logistics" }, { "name": "ddd-lookup", "description": "B2B SEO Search Tag: ddd-lookup" }, { "name": "ecommerce-checkout", "description": "B2B SEO Search Tag: ecommerce-checkout" } ], "security": [ { "ApifyCloudBearerAuth": [] }, { "RapidAPIProxySecret": [] }, { "ZylaProxySecret": [] }, { "RapidAPISubscriberKey": [] } ], "paths": { "/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run_sync_brazil_cep_geocoordinates_logistics_auditor", "summary": "Execute Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor (Apify Cloud Synchronous POST)", "description": "Synchronous stateless execution of **Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor**. RapidAPI Studio and Zyla API Hub inject the backend secret header `Authorization: Bearer ` invisibly to the end user, validate `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` in constant time (`hmac.compare_digest`), inject quota headers (`X-RateLimit-Remaining`, `X-Engine-Version`), and return deterministic JSON records.", "tags": [ "Logistics", "brazil-cep-lookup", "postal-geocoding", "ibge-municipality-code", "nfe-address-validator", "last-mile-logistics" ], "x-codeSamples": [ { "lang": "cURL", "label": "cURL", "source": "# Primary Synchronous Endpoint: https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\ncurl --request POST \\\n --url \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5}'" }, { "lang": "Python", "label": "Python (httpx)", "source": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nurl = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\"\npayload = {\n \"ceps\": \"01310100,20040002,30140071\",\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n" }, { "lang": "Node.js", "label": "Node.js (fetch)", "source": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nconst url = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" } ], "x-snippets": { "cURL": "# Primary Synchronous Endpoint: https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\ncurl --request POST \\\n --url \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5}'", "Python": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nurl = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\"\npayload = {\n \"ceps\": \"01310100,20040002,30140071\",\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n", "Node.js": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nconst url = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" }, "x-backend-secret-header": { "name": "Authorization", "value": "Bearer ", "visibleToSubscriber": false }, "requestBody": { "required": true, "description": "Structured JSON parameters for `brazil-cep-geocoordinates-logistics-auditor`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilCepGeocoordinatesLogisticsAuditorRequest" }, "example": { "ceps": "01310100,20040002,30140071", "maxResults": 5 } } } }, "responses": { "200": { "description": "Successful synchronous execution of `brazil-cep-geocoordinates-logistics-auditor` returning enriched B2B JSON records.", "headers": { "X-RateLimit-Remaining": { "description": "Remaining requests in the subscriber's monthly plan quota (BASIC=15, PRO=1000, ULTRA=5000, MEGA=25000).", "schema": { "type": "integer", "example": 999 } }, "X-Engine-Version": { "description": "Deterministic B2B engine release version.", "schema": { "type": "string", "example": "3.0.0" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilCepGeocoordinatesLogisticsAuditorResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-cep-geocoordinates-logistics-auditor", "engineVersion": "3.0.0", "count": 1, "data": [ { "cep": "01310100", "stateUf": "SP", "cityName": "São Paulo", "neighborhood": "Bela Vista", "street": "Avenida Paulista", "ibgeCityCode": "3550308", "latitude": -23.5475, "longitude": -46.63611, "logisticsReadinessScore": 100, "markdownLogisticsDossier": "# BRAZIL CEP GEOCOORDINATES & NF-e LOGISTICS DOSSIER: 01310100\n\n## 1. Standardized Address & Tax Jurisdiction\n- **CEP (8 Digits):** `01310100`\n- **Municipality / State UF:** **São Paulo - SP**\n- **IBGE 7-Digit City Code (NF-e/CT-e):** `3550308`\n- **Neighborhood:** `Bela Vista`\n- **Street / Logradouro:** Avenida Paulista\n\n## 2. Last-Mile Geocoordinates & Readiness\n- **Logistics & NF-e Readiness Score:** **100/100**\n- **WGS84 Coordinates:** `(-23.5475, -46.63611)`" } ] } } } }, "201": { "description": "Synchronous dataset created and returned for `brazil-cep-geocoordinates-logistics-auditor` on Apify Cloud (`HTTP 201`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilCepGeocoordinatesLogisticsAuditorResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-cep-geocoordinates-logistics-auditor", "engineVersion": "3.0.0", "count": 1, "data": [ { "cep": "01310100", "stateUf": "SP", "cityName": "São Paulo", "neighborhood": "Bela Vista", "street": "Avenida Paulista", "ibgeCityCode": "3550308", "latitude": -23.5475, "longitude": -46.63611, "logisticsReadinessScore": 100, "markdownLogisticsDossier": "# BRAZIL CEP GEOCOORDINATES & NF-e LOGISTICS DOSSIER: 01310100\n\n## 1. Standardized Address & Tax Jurisdiction\n- **CEP (8 Digits):** `01310100`\n- **Municipality / State UF:** **São Paulo - SP**\n- **IBGE 7-Digit City Code (NF-e/CT-e):** `3550308`\n- **Neighborhood:** `Bela Vista`\n- **Street / Logradouro:** Avenida Paulista\n\n## 2. Last-Mile Geocoordinates & Readiness\n- **Logistics & NF-e Readiness Score:** **100/100**\n- **WGS84 Coordinates:** `(-23.5475, -46.63611)`" } ] } } } }, "400": { "description": "Bad Request — Invalid JSON payload or schema validation error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "error", "code": 400, "message": "Invalid JSON request body." } } } }, "403": { "description": "Forbidden — Missing or invalid `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` header (Anti-Bypass Protection).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "forbidden", "code": 403, "message": "Direct access denied. Requests must originate from RapidAPI Hub or Zyla API Hub with a valid Proxy-Secret." } } } }, "429": { "description": "Too Many Requests — Monthly plan quota exceeded (e.g., BASIC Freemium 15 req/month hard limit).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "quota_exceeded", "code": 429, "message": "Monthly request quota exceeded for BASIC plan (15 req/month hard limit). Upgrade to PRO ($19/mo), ULTRA ($49/mo), or MEGA ($149/mo)." } } } } } } }, "/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor": { "get": { "operationId": "status_brazil_cep_geocoordinates_logistics_auditor", "summary": "Actor Metadata & Live Connectivity Check for Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor", "description": "Immediate `HTTP 200` status and metadata health check for `brazil-cep-geocoordinates-logistics-auditor` on RapidAPI Studio and Zyla API Hub (`GET https://api.apify.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor` and `GET /v1/brazil-cep-geocoordinates-logistics-auditor/health`) without starting a container build or run.", "tags": [ "Logistics" ], "responses": { "200": { "description": "Engine online and ready (`HTTP 200 JSON`).", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "ok" }, "actor": { "type": "string", "example": "brazil-cep-geocoordinates-logistics-auditor" }, "engineVersion": { "type": "string", "example": "3.0.0" }, "category": { "type": "string", "example": "Logistics" }, "data": { "type": "object", "additionalProperties": true, "example": { "name": "brazil-cep-geocoordinates-logistics-auditor", "username": "b2b-quant-apis", "isPublic": true } } } }, "example": { "status": "ok", "actor": "brazil-cep-geocoordinates-logistics-auditor", "engineVersion": "3.0.0", "category": "Logistics", "data": { "name": "brazil-cep-geocoordinates-logistics-auditor", "username": "b2b-quant-apis", "isPublic": true } } } } } } } }, "/v1/brazil-cep-geocoordinates-logistics-auditor": { "post": { "operationId": "execute_brazil_cep_geocoordinates_logistics_auditor", "summary": "Execute Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor", "description": "Synchronous stateless execution of **Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor**. RapidAPI Studio and Zyla API Hub inject the backend secret header `Authorization: Bearer ` invisibly to the end user, validate `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` in constant time (`hmac.compare_digest`), inject quota headers (`X-RateLimit-Remaining`, `X-Engine-Version`), and return deterministic JSON records.", "tags": [ "Logistics", "brazil-cep-lookup", "postal-geocoding", "ibge-municipality-code", "nfe-address-validator", "last-mile-logistics" ], "x-codeSamples": [ { "lang": "cURL", "label": "cURL", "source": "# Primary Synchronous Endpoint: https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\ncurl --request POST \\\n --url \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5}'" }, { "lang": "Python", "label": "Python (httpx)", "source": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nurl = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\"\npayload = {\n \"ceps\": \"01310100,20040002,30140071\",\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n" }, { "lang": "Node.js", "label": "Node.js (fetch)", "source": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nconst url = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" } ], "x-snippets": { "cURL": "# Primary Synchronous Endpoint: https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\ncurl --request POST \\\n --url \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\" \\\n --header \"Content-Type: application/json\" \\\n --header \"X-RapidAPI-Host: brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\" \\\n --header \"X-RapidAPI-Key: \" \\\n --data '{\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5}'", "Python": "import httpx\n\n# Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nurl = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\"\npayload = {\n \"ceps\": \"01310100,20040002,30140071\",\n \"maxResults\": 5\n}\nheaders = {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\",\n}\n\nwith httpx.Client(timeout=30.0) as client:\n response = client.post(url, json=payload, headers=headers)\n response.raise_for_status()\n print(response.json())\n", "Node.js": "// Primary Synchronous Endpoint (Gateway Route: https://b2b-quant-rapidapi-gateway.jesleytassili.workers.dev/v1/brazil-cep-geocoordinates-logistics-auditor)\nconst url = \"https://brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor/run-sync-get-dataset-items\";\nconst options = {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"X-RapidAPI-Host\": \"brazil-cep-geocoordinates-logistics-auditor.p.rapidapi.com\",\n \"X-RapidAPI-Key\": \"\"\n },\n body: JSON.stringify({\"ceps\": \"01310100,20040002,30140071\", \"maxResults\": 5})\n};\n\nconst response = await fetch(url, options);\nconst data = await response.json();\nconsole.log(data);\n" }, "x-backend-secret-header": { "name": "Authorization", "value": "Bearer ", "visibleToSubscriber": false }, "requestBody": { "required": true, "description": "Structured JSON parameters for `brazil-cep-geocoordinates-logistics-auditor`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilCepGeocoordinatesLogisticsAuditorRequest" }, "example": { "ceps": "01310100,20040002,30140071", "maxResults": 5 } } } }, "responses": { "200": { "description": "Successful synchronous execution of `brazil-cep-geocoordinates-logistics-auditor` returning enriched B2B JSON records.", "headers": { "X-RateLimit-Remaining": { "description": "Remaining requests in the subscriber's monthly plan quota (BASIC=15, PRO=1000, ULTRA=5000, MEGA=25000).", "schema": { "type": "integer", "example": 999 } }, "X-Engine-Version": { "description": "Deterministic B2B engine release version.", "schema": { "type": "string", "example": "3.0.0" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilCepGeocoordinatesLogisticsAuditorResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-cep-geocoordinates-logistics-auditor", "engineVersion": "3.0.0", "count": 1, "data": [ { "cep": "01310100", "stateUf": "SP", "cityName": "São Paulo", "neighborhood": "Bela Vista", "street": "Avenida Paulista", "ibgeCityCode": "3550308", "latitude": -23.5475, "longitude": -46.63611, "logisticsReadinessScore": 100, "markdownLogisticsDossier": "# BRAZIL CEP GEOCOORDINATES & NF-e LOGISTICS DOSSIER: 01310100\n\n## 1. Standardized Address & Tax Jurisdiction\n- **CEP (8 Digits):** `01310100`\n- **Municipality / State UF:** **São Paulo - SP**\n- **IBGE 7-Digit City Code (NF-e/CT-e):** `3550308`\n- **Neighborhood:** `Bela Vista`\n- **Street / Logradouro:** Avenida Paulista\n\n## 2. Last-Mile Geocoordinates & Readiness\n- **Logistics & NF-e Readiness Score:** **100/100**\n- **WGS84 Coordinates:** `(-23.5475, -46.63611)`" } ] } } } }, "201": { "description": "Synchronous dataset created and returned for `brazil-cep-geocoordinates-logistics-auditor` on Apify Cloud (`HTTP 201`).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrazilCepGeocoordinatesLogisticsAuditorResponseEnvelope" }, "example": { "status": "succeeded", "actor": "brazil-cep-geocoordinates-logistics-auditor", "engineVersion": "3.0.0", "count": 1, "data": [ { "cep": "01310100", "stateUf": "SP", "cityName": "São Paulo", "neighborhood": "Bela Vista", "street": "Avenida Paulista", "ibgeCityCode": "3550308", "latitude": -23.5475, "longitude": -46.63611, "logisticsReadinessScore": 100, "markdownLogisticsDossier": "# BRAZIL CEP GEOCOORDINATES & NF-e LOGISTICS DOSSIER: 01310100\n\n## 1. Standardized Address & Tax Jurisdiction\n- **CEP (8 Digits):** `01310100`\n- **Municipality / State UF:** **São Paulo - SP**\n- **IBGE 7-Digit City Code (NF-e/CT-e):** `3550308`\n- **Neighborhood:** `Bela Vista`\n- **Street / Logradouro:** Avenida Paulista\n\n## 2. Last-Mile Geocoordinates & Readiness\n- **Logistics & NF-e Readiness Score:** **100/100**\n- **WGS84 Coordinates:** `(-23.5475, -46.63611)`" } ] } } } }, "400": { "description": "Bad Request — Invalid JSON payload or schema validation error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "error", "code": 400, "message": "Invalid JSON request body." } } } }, "403": { "description": "Forbidden — Missing or invalid `X-RapidAPI-Proxy-Secret` / `X-Zyla-Proxy-Secret` header (Anti-Bypass Protection).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "forbidden", "code": 403, "message": "Direct access denied. Requests must originate from RapidAPI Hub or Zyla API Hub with a valid Proxy-Secret." } } } }, "429": { "description": "Too Many Requests — Monthly plan quota exceeded (e.g., BASIC Freemium 15 req/month hard limit).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "status": "quota_exceeded", "code": 429, "message": "Monthly request quota exceeded for BASIC plan (15 req/month hard limit). Upgrade to PRO ($19/mo), ULTRA ($49/mo), or MEGA ($149/mo)." } } } } } } }, "/v1/brazil-cep-geocoordinates-logistics-auditor/health": { "get": { "operationId": "health_brazil_cep_geocoordinates_logistics_auditor", "summary": "Health & SLA Check for Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor", "description": "Immediate `HTTP 200` status and metadata health check for `brazil-cep-geocoordinates-logistics-auditor` on RapidAPI Studio and Zyla API Hub (`GET https://api.apify.com/v2/acts/b2b-quant-apis~brazil-cep-geocoordinates-logistics-auditor` and `GET /v1/brazil-cep-geocoordinates-logistics-auditor/health`) without starting a container build or run.", "tags": [ "Logistics" ], "responses": { "200": { "description": "Engine online and ready (`HTTP 200 JSON`).", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "ok" }, "actor": { "type": "string", "example": "brazil-cep-geocoordinates-logistics-auditor" }, "engineVersion": { "type": "string", "example": "3.0.0" }, "category": { "type": "string", "example": "Logistics" }, "data": { "type": "object", "additionalProperties": true, "example": { "name": "brazil-cep-geocoordinates-logistics-auditor", "username": "b2b-quant-apis", "isPublic": true } } } }, "example": { "status": "ok", "actor": "brazil-cep-geocoordinates-logistics-auditor", "engineVersion": "3.0.0", "category": "Logistics", "data": { "name": "brazil-cep-geocoordinates-logistics-auditor", "username": "b2b-quant-apis", "isPublic": true } } } } } } } } }, "components": { "securitySchemes": { "ApifyCloudBearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "APIFY_API_TOKEN", "description": "Backend Secret Header (`Authorization: Bearer `) injected invisibly by RapidAPI Studio and Zyla API Hub proxy when calling https://api.apify.com." }, "RapidAPIProxySecret": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Proxy-Secret", "description": "RapidAPI Hub shared proxy secret verified in constant time via hmac.compare_digest." }, "ZylaProxySecret": { "type": "apiKey", "in": "header", "name": "X-Zyla-Proxy-Secret", "description": "Zyla API Hub shared proxy secret verified in constant time via hmac.compare_digest." }, "RapidAPISubscriberKey": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Key", "description": "Subscriber API Key injected by RapidAPI Hub or Zyla API Hub." } }, "schemas": { "BrazilCepGeocoordinatesLogisticsAuditorRequest": { "type": "object", "title": "Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor Request Schema", "description": "Input parameters for Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor.", "properties": { "ceps": { "type": "string", "title": "Brazilian 8-Digit CEPs (CSV)", "description": "Comma-separated Brazilian postal codes (e.g., '01310100, 20040002, 30140071').", "default": "01310100,20040002,30140071", "example": "01310100,20040002,30140071" }, "maxResults": { "type": "integer", "title": "Max CEPs to Audit", "description": "Maximum number of CEP records to return (1 to 100).", "default": 10, "minimum": 1, "maximum": 100, "example": 5 } }, "required": [ "ceps" ], "example": { "ceps": "01310100,20040002,30140071", "maxResults": 5 } }, "BrazilCepGeocoordinatesLogisticsAuditorRecord": { "type": "object", "title": "Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor Output Record", "description": "Enriched B2B dataset item returned by `brazil-cep-geocoordinates-logistics-auditor`.", "properties": { "cep": { "type": "string", "title": "CEP (8 Digits)", "description": "Standardized 8-digit Brazilian postal code.", "example": "01310100" }, "stateUf": { "type": "string", "title": "State UF", "description": "Two-letter Brazilian state code.", "example": "SP" }, "cityName": { "type": "string", "title": "City / Municipality", "description": "Official municipality name.", "example": "São Paulo" }, "neighborhood": { "type": "string", "title": "Neighborhood / Bairro", "description": "District or neighborhood.", "example": "Bela Vista" }, "street": { "type": "string", "title": "Street / Logradouro", "description": "Street address.", "example": "Avenida Paulista" }, "ibgeCityCode": { "type": "string", "title": "IBGE 7-Digit City Code", "description": "Official 7-digit IBGE municipality code for NF-e/CT-e.", "example": "3550308" }, "latitude": { "type": "number", "title": "Latitude", "description": "WGS84 Latitude coordinate.", "example": -23.5475 }, "longitude": { "type": "number", "title": "Longitude", "description": "WGS84 Longitude coordinate.", "example": -46.63611 }, "logisticsReadinessScore": { "type": "integer", "title": "Logistics & NF-e Readiness Score (0-100)", "description": "Quantitative score for last-mile routing and tax invoice completeness (0-100).", "example": 100 }, "markdownLogisticsDossier": { "type": "string", "title": "Markdown Logistics & NF-e Dossier", "description": "Executive report for e-commerce, TMS/WMS, and ERP tax engines.", "example": "# BRAZIL CEP GEOCOORDINATES & NF-e LOGISTICS DOSSIER: 01310100\n\n## 1. Standardized Address & Tax Jurisdiction\n- **CEP (8 Digits):** `01310100`\n- **Municipality / State UF:** **São Paulo - SP**\n- **IBGE 7-Digit City Code (NF-e/CT-e):** `3550308`\n- **Neighborhood:** `Bela Vista`\n- **Street / Logradouro:** Avenida Paulista\n\n## 2. Last-Mile Geocoordinates & Readiness\n- **Logistics & NF-e Readiness Score:** **100/100**\n- **WGS84 Coordinates:** `(-23.5475, -46.63611)`" } }, "example": { "cep": "01310100", "stateUf": "SP", "cityName": "São Paulo", "neighborhood": "Bela Vista", "street": "Avenida Paulista", "ibgeCityCode": "3550308", "latitude": -23.5475, "longitude": -46.63611, "logisticsReadinessScore": 100, "markdownLogisticsDossier": "# BRAZIL CEP GEOCOORDINATES & NF-e LOGISTICS DOSSIER: 01310100\n\n## 1. Standardized Address & Tax Jurisdiction\n- **CEP (8 Digits):** `01310100`\n- **Municipality / State UF:** **São Paulo - SP**\n- **IBGE 7-Digit City Code (NF-e/CT-e):** `3550308`\n- **Neighborhood:** `Bela Vista`\n- **Street / Logradouro:** Avenida Paulista\n\n## 2. Last-Mile Geocoordinates & Readiness\n- **Logistics & NF-e Readiness Score:** **100/100**\n- **WGS84 Coordinates:** `(-23.5475, -46.63611)`" } }, "BrazilCepGeocoordinatesLogisticsAuditorResponseEnvelope": { "type": "object", "title": "Brazil CEP Geocoordinates, IBGE Code & Logistics Auditor Synchronous Response Envelope", "required": [ "status", "actor", "count", "data" ], "properties": { "status": { "type": "string", "example": "succeeded" }, "actor": { "type": "string", "example": "brazil-cep-geocoordinates-logistics-auditor" }, "marketplace": { "type": "string", "example": "rapidapi_zyla_hub" }, "engineVersion": { "type": "string", "example": "3.0.0" }, "count": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/BrazilCepGeocoordinatesLogisticsAuditorRecord" } } }, "example": { "status": "succeeded", "actor": "brazil-cep-geocoordinates-logistics-auditor", "engineVersion": "3.0.0", "count": 1, "data": [ { "cep": "01310100", "stateUf": "SP", "cityName": "São Paulo", "neighborhood": "Bela Vista", "street": "Avenida Paulista", "ibgeCityCode": "3550308", "latitude": -23.5475, "longitude": -46.63611, "logisticsReadinessScore": 100, "markdownLogisticsDossier": "# BRAZIL CEP GEOCOORDINATES & NF-e LOGISTICS DOSSIER: 01310100\n\n## 1. Standardized Address & Tax Jurisdiction\n- **CEP (8 Digits):** `01310100`\n- **Municipality / State UF:** **São Paulo - SP**\n- **IBGE 7-Digit City Code (NF-e/CT-e):** `3550308`\n- **Neighborhood:** `Bela Vista`\n- **Street / Logradouro:** Avenida Paulista\n\n## 2. Last-Mile Geocoordinates & Readiness\n- **Logistics & NF-e Readiness Score:** **100/100**\n- **WGS84 Coordinates:** `(-23.5475, -46.63611)`" } ] } }, "ErrorResponse": { "type": "object", "required": [ "status", "code", "message" ], "properties": { "status": { "type": "string", "example": "error" }, "code": { "type": "integer", "example": 403 }, "message": { "type": "string", "example": "Direct access denied." } } } } } }