Developer Documentation

API Documentation

Everything you need to integrate GiraShare proxies into your applications. Connect via HTTP, HTTPS, or SOCKS5 in minutes.

Quick Start

Get up and running with GiraShare proxies in three simple steps.

  1. 1

    Create your account

    Sign up at girashare.com and choose a plan that fits your needs.

  2. 2

    Get your credentials

    Navigate to your dashboard to find your proxy username and password.

  3. 3

    Connect to the gateway

    Use the gateway endpoint to route your traffic:

Gateway Endpoint
gw.dataimpulse.com:823

Connection Methods

GiraShare supports both HTTP/HTTPS and SOCKS5 protocols. Use whichever is compatible with your tooling.

HTTP / HTTPS

http://username:[email protected]:823

SOCKS5

socks5://username:[email protected]:823

Code Examples

Copy-paste examples for popular languages and frameworks. Replace USERNAME and PASSWORD with your dashboard credentials.

Python (requests)

python
import requests

proxies = {
    "http": "http://USERNAME:[email protected]:823",
    "https": "http://USERNAME:[email protected]:823",
}

response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())

Python (aiohttp)

python
import aiohttp

async def fetch():
    proxy = "http://USERNAME:[email protected]:823"
    async with aiohttp.ClientSession() as session:
        async with session.get("https://httpbin.org/ip", proxy=proxy) as resp:
            print(await resp.json())

Node.js (axios)

javascript
const axios = require('axios');
const HttpsProxyAgent = require('https-proxy-agent');

const agent = new HttpsProxyAgent('http://USERNAME:[email protected]:823');

const response = await axios.get('https://httpbin.org/ip', { httpsAgent: agent });
console.log(response.data);

cURL

bash
curl -x http://USERNAME:[email protected]:823 https://httpbin.org/ip

Scrapy (settings.py)

python
DOWNLOADER_MIDDLEWARES = {
    'scrapy.downloadermiddlewares.httpproxy.HttpProxyMiddleware': 110,
}
HTTP_PROXY = 'http://USERNAME:[email protected]:823'

Geo-Targeting

Target specific locations by appending parameters to your username. Available in 195+ countries worldwide.

TargetingUsername Format
Countryuser-country-XX
Cityuser-country-XX-city-name
Stateuser-country-XX-state-name

Session Control

Control IP rotation behavior to match your use case.

Rotating IPs

Default behavior. Each request receives a new IP address from the pool. Ideal for web scraping and data collection.

username:password

Sticky Sessions

Maintain the same IP for up to 10 minutes. Append a session ID to your username. Perfect for account management.

username-session-abc123:password

Combined Example

Combined: Country + Sticky Session
user123-country-us-session-mysession1:password

Response Codes

Common HTTP response codes you may encounter when using the proxy gateway.

CodeMeaning
200Success
407Authentication failed
429Rate limited
502Proxy error
503Service unavailable

Best Practices

Use rotating IPs for scraping

Rotating proxies distribute requests across many IPs, reducing the chance of blocks during data collection.

Use sticky sessions for accounts

When managing accounts or maintaining login state, sticky sessions keep you on the same IP for consistency.

Implement retry logic

Use exponential backoff on 502/503 errors. Start with a 1-second delay and double it on each retry, up to a maximum.

Monitor bandwidth usage

Track your consumption in the GiraShare dashboard to avoid overages and optimize your plan selection.

Target by country for speed

Using geo-targeting to select a country close to your target website reduces latency and improves response times.

Rotate user agents

Pair proxy rotation with varied user agent strings for a more natural request pattern.

Support

Need help? Our team is here to assist you with integration and troubleshooting.

Email Support

[email protected]

Dashboard

girashare.giraffos.com/dashboard

Back to top