How to Use GProxy Proxies with Apify Actors

TL;DR

Configure GProxy residential and datacenter proxies with Apify actors for web scraping. Covers proxy configuration, Crawlee integration, and cost optimization.

Get Proxies → Apify website →

Language: JavaScript / Platform

Prerequisites

✓[
✓"
✓A
✓p
✓i
✓f
✓y
✓
✓a
✓c
✓c
✓o
✓u
✓n
✓t
✓
✓(
✓f
✓r
✓e
✓e
✓
✓o
✓r
✓
✓p
✓a
✓i
✓d
✓)
✓"
✓,
✓
✓"
✓N
✓o
✓d
✓e
✓.
✓j
✓s
✓
✓1
✓6
✓+
✓
✓f
✓o
✓r
✓
✓l
✓o
✓c
✓a
✓l
✓
✓d
✓e
✓v
✓e
✓l
✓o
✓p
✓m
✓e
✓n
✓t
✓"
✓,
✓
✓"
✓G
✓P
✓r
✓o
✓x
✓y
✓
✓a
✓c
✓c
✓o
✓u
✓n
✓t
✓
✓w
✓i
✓t
✓h
✓
✓a
✓c
✓t
✓i
✓v
✓e
✓
✓p
✓r
✓o
✓x
✓y
✓
✓p
✓l
✓a
✓n
✓"
✓,
✓
✓"
✓F
✓a
✓m
✓i
✓l
✓i
✓a
✓r
✓i
✓t
✓y
✓
✓w
✓i
✓t
✓h
✓
✓A
✓p
✓i
✓f
✓y
✓
✓a
✓c
✓t
✓o
✓r
✓s
✓
✓o
✓r
✓
✓C
✓r
✓a
✓w
✓l
✓e
✓e
✓"
✓]

Step-by-Step Setup

[

{

"

T

I

T

L

E

"

:

"

I

N

S

T

A

L

C

R

A

W

L

E

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

S

E

T

U

P

A

C

R

A

W

L

E

P

R

O

J

E

C

T

F

O

R

Y

O

U

R

A

C

T

O

R

"

,

"

C

O

D

E

"

:

"

N

P

100

X

101

102

C

103

R

104

A

105

W

106

L

107

E

108

E

109

110

C

111

R

112

E

113

A

114

T

115

E

116

117

M

118

Y

119

-

120

S

121

C

122

R

123

A

124

P

125

E

126

R

127

\

128

N

129

C

130

D

131

132

M

133

Y

134

-

135

S

136

C

137

R

138

A

139

P

140

E

141

R

142

\

143

N

144

N

145

P

146

M

147

148

I

149

N

150

S

151

T

152

A

153

L

154

L

155

"

156

}

157

,

158

159

{

160

"

161

T

162

I

163

T

164

L

165

E

166

"

167

:

168

169

"

170

C

171

O

172

N

173

F

174

I

175

G

176

U

177

R

178

E

179

180

G

181

P

182

R

183

O

184

X

185

Y

186

187

A

188

S

189

190

E

191

X

192

T

193

E

194

R

195

N

196

A

197

L

198

199

P

200

R

201

O

202

X

203

Y

204

"

205

,

206

207

"

208

D

209

E

210

S

211

C

212

R

213

I

214

P

215

T

216

I

217

O

218

N

219

"

220

:

221

222

"

223

S

224

E

225

T

226

227

U

228

P

229

230

P

231

R

232

O

233

X

234

Y

235

C

236

O

237

N

238

F

239

I

240

G

241

U

242

R

243

A

244

T

245

I

246

O

247

N

248

249

W

250

I

251

T

252

H

253

254

G

255

P

256

R

257

O

258

X

259

Y

260

261

U

262

R

263

L

264

"

265

,

266

267

"

268

C

269

O

270

D

271

E

272

"

273

:

274

275

"

276

I

277

M

278

P

279

O

280

R

281

T

282

283

{

284

285

P

286

R

287

O

288

X

289

Y

290

C

291

O

292

N

293

F

294

I

295

G

296

U

297

R

298

A

299

T

300

I

301

O

302

N

303

304

}

305

306

F

307

R

308

O

309

M

310

311

'

312

C

313

R

314

A

315

W

316

L

317

E

318

E

319

'

320

;

321

\

322

N

323

\

324

N

325

C

326

O

327

N

328

S

329

T

330

331

P

332

R

333

O

334

X

335

Y

336

C

337

O

338

N

339

F

340

I

341

G

342

343

=

344

345

N

346

E

347

W

348

349

P

350

R

351

O

352

X

353

Y

354

C

355

O

356

N

357

F

358

I

359

G

360

U

361

R

362

A

363

T

364

I

365

O

366

N

367

(

368

{

369

\

370

N

371

372

373

P

374

R

375

O

376

X

377

Y

378

U

379

R

380

L

381

S

382

:

383

384

[

385

'

386

H

387

T

388

T

389

P

390

:

391

/

392

/

393

U

394

S

395

E

396

R

397

:

398

P

399

A

400

S

401

S

402

@

403

P

404

R

405

O

406

X

407

Y

408

.

409

G

410

P

411

R

412

O

413

X

414

Y

415

.

416

N

417

E

418

T

419

:

420

1

421

0

422

0

423

0

424

'

425

]

426

\

427

N

428

}

429

)

430

;

431

"

432

}

433

,

434

435

{

436

"

437

T

438

I

439

T

440

L

441

E

442

"

443

:

444

445

"

446

U

447

S

448

E

449

450

W

451

I

452

T

453

H

454

455

C

456

H

457

E

458

E

459

R

460

I

461

O

462

C

463

R

464

A

465

W

466

L

467

E

468

R

469

"

470

,

471

472

"

473

D

474

E

475

S

476

C

477

R

478

I

479

P

480

T

481

I

482

O

483

N

484

"

485

:

486

487

"

488

A

489

D

490

D

491

492

P

493

R

494

O

495

X

496

Y

497

498

T

499

O

500

501

Y

502

O

503

U

504

R

505

506

C

507

H

508

E

509

E

510

R

511

I

512

O

513

-

514

B

515

A

516

S

517

E

518

D

519

520

S

521

C

522

R

523

A

524

P

525

E

526

R

527

"

528

,

529

530

"

531

C

532

O

533

D

534

E

535

"

536

:

537

538

"

539

I

540

M

541

P

542

O

543

R

544

T

545

546

{

547

548

C

549

H

550

E

551

E

552

R

553

I

554

O

555

C

556

R

557

A

558

W

559

L

560

E

561

R

562

563

}

564

565

F

566

R

567

O

568

M

569

570

'

571

C

572

R

573

A

574

W

575

L

576

E

577

E

578

'

579

;

580

\

581

N

582

\

583

N

584

C

585

O

586

N

587

S

588

T

589

590

C

591

R

592

A

593

W

594

L

595

E

596

R

597

598

=

599

600

N

601

E

602

W

603

604

C

605

H

606

E

607

E

608

R

609

I

610

O

611

C

612

R

613

A

614

W

615

L

616

E

617

R

618

(

619

{

620

\

621

N

622

623

624

P

625

R

626

O

627

X

628

Y

629

C

630

O

631

N

632

F

633

I

634

G

635

U

636

R

637

A

638

T

639

I

640

O

641

N

642

:

643

644

P

645

R

646

O

647

X

648

Y

649

C

650

O

651

N

652

F

653

I

654

G

655

,

656

\

657

N

658

659

660

A

661

S

662

Y

663

N

664

C

665

666

R

667

E

668

Q

669

U

670

E

671

S

672

T

673

H

674

A

675

N

676

D

677

L

678

E

679

R

680

(

681

{

682

683

R

684

E

685

Q

686

U

687

E

688

S

689

T

690

,

691

692

$

693

694

}

695

)

696

697

{

698

\

699

N

700

701

702

703

704

C

705

O

706

N

707

S

708

T

709

710

T

711

I

712

T

713

L

714

E

715

716

=

717

718

$

719

(

720

'

721

T

722

I

723

T

724

L

725

E

726

'

727

)

728

.

729

T

730

E

731

X

732

T

733

(

734

)

735

;

736

\

737

N

738

739

740

741

742

C

743

O

744

N

745

S

746

O

747

L

748

E

749

.

750

L

751

O

752

G

753

(

754

T

755

I

756

T

757

L

758

E

759

)

760

;

761

\

762

N

763

764

765

}

766

\

767

N

768

}

769

)

770

;

771

"

772

}

773

,

774

775

{

776

"

777

T

778

I

779

T

780

L

781

E

782

"

783

:

784

785

"

786

U

787

S

788

E

789

790

W

791

I

792

T

793

H

794

795

P

796

L

797

A

798

Y

799

W

800

R

801

I

802

G

803

H

804

T

805

C

806

R

807

A

808

W

809

L

810

E

811

R

812

"

813

,

814

815

"

816

D

817

E

818

S

819

C

820

R

821

I

822

P

823

T

824

I

825

O

826

N

827

"

828

:

829

830

"

831

A

832

D

833

D

834

835

P

836

R

837

O

838

X

839

Y

840

841

T

842

O

843

844

B

845

R

846

O

847

W

848

S

849

E

850

R

851

-

852

B

853

A

854

S

855

E

856

D

857

858

S

859

C

860

R

861

A

862

P

863

E

864

R

865

"

866

,

867

868

"

869

C

870

O

871

D

872

E

873

"

874

:

875

876

"

877

I

878

M

879

P

880

O

881

R

882

T

883

884

{

885

886

P

887

L

888

A

889

Y

890

W

891

R

892

I

893

G

894

H

895

T

896

C

897

R

898

A

899

W

900

L

901

E

902

R

903

904

}

905

906

F

907

R

908

O

909

M

910

911

'

912

C

913

R

914

A

915

W

916

L

917

E

918

E

919

'

920

;

921

\

922

N

923

\

924

N

925

C

926

O

927

N

928

S

929

T

930

931

C

932

R

933

A

934

W

935

L

936

E

937

R

938

939

=

940

941

N

942

E

943

W

944

945

P

946

L

947

A

948

Y

949

W

950

R

951

I

952

G

953

H

954

T

955

C

956

R

957

A

958

W

959

L

960

E

961

R

962

(

963

{

964

\

965

N

966

967

968

P

969

R

970

O

971

X

972

Y

973

C

974

O

975

N

976

F

977

I

978

G

979

U

980

R

981

A

982

T

983

I

984

O

985

N

986

:

987

988

P

989

R

990

O

991

X

992

Y

993

C

994

O

995

N

996

F

997

I

998

G

999

,

1000

\

1001

N

1002

1003

1004

A

1005

S

1006

Y

1007

N

1008

C

1009

1010

R

1011

E

1012

Q

1013

U

1014

E

1015

S

1016

T

1017

H

1018

A

1019

N

1020

D

1021

L

1022

E

1023

R

1024

(

1025

{

1026

1027

P

1028

A

1029

G

1030

E

1031

1032

}

1033

)

1034

1035

{

1036

\

1037

N

1038

1039

1040

1041

1042

C

1043

O

1044

N

1045

S

1046

T

1047

1048

T

1049

I

1050

T

1051

L

1052

E

1053

1054

=

1055

1056

A

1057

W

1058

A

1059

I

1060

T

1061

1062

P

1063

A

1064

G

1065

E

1066

.

1067

T

1068

I

1069

T

1070

L

1071

E

1072

(

1073

)

1074

;

1075

\

1076

N

1077

1078

1079

1080

1081

C

1082

O

1083

N

1084

S

1085

O

1086

L

1087

E

1088

.

1089

L

1090

O

1091

G

1092

(

1093

T

1094

I

1095

T

1096

L

1097

E

1098

)

1099

;

1100

\

1101

N

1102

1103

1104

}

1105

\

1106

N

1107

}

1108

)

1109

;

1110

"

1111

}

1112

,

1113

1114

{

1115

"

1116

T

1117

I

1118

T

1119

L

1120

E

1121

"

1122

:

1123

1124

"

1125

D

1126

E

1127

P

1128

L

1129

O

1130

Y

1131

1132

T

1133

O

1134

1135

A

1136

P

1137

I

1138

F

1139

Y

1140

"

1141

,

1142

1143

"

1144

D

1145

E

1146

S

1147

C

1148

R

1149

I

1150

P

1151

T

1152

I

1153

O

1154

N

1155

"

1156

:

1157

1158

"

1159

P

1160

U

1161

S

1162

H

1163

1164

Y

1165

O

1166

U

1167

R

1168

1169

A

1170

C

1171

T

1172

O

1173

R

1174

1175

T

1176

O

1177

1178

T

1179

H

1180

E

1181

1182

A

1183

P

1184

I

1185

F

1186

Y

1187

1188

P

1189

L

1190

A

1191

T

1192

F

1193

O

1194

R

1195

M

1196

"

1197

,

1198

1199

"

1200

C

1201

O

1202

D

1203

E

1204

"

1205

:

1206

1207

"

1208

A

1209

P

1210

I

1211

F

1212

Y

1213

1214

L

1215

O

1216

G

1217

I

1218

N

1219

\

1220

N

1221

A

1222

P

1223

I

1224

F

1225

Y

1226

1227

P

1228

U

1229

S

1230

H

1231

"

1232

}

1233

,

1234

1235

{

1236

"

1237

T

1238

I

1239

T

1240

L

1241

E

1242

"

1243

:

1244

1245

"

1246

S

1247

E

1248

T

1249

1250

P

1251

R

1252

O

1253

X

1254

Y

1255

1256

I

1257

N

1258

1259

A

1260

P

1261

I

1262

F

1263

Y

1264

1265

C

1266

O

1267

N

1268

S

1269

O

1270

L

1271

E

1272

"

1273

,

1274

1275

"

1276

D

1277

E

1278

S

1279

C

1280

R

1281

I

1282

P

1283

T

1284

I

1285

O

1286

N

1287

"

1288

:

1289

1290

"

1291

C

1292

O

1293

N

1294

F

1295

I

1296

G

1297

U

1298

R

1299

E

1300

1301

P

1302

R

1303

O

1304

X

1305

Y

1306

1307

U

1308

R

1309

L

1310

1311

I

1312

N

1313

1314

A

1315

C

1316

T

1317

O

1318

R

1319

1320

I

1321

N

1322

P

1323

U

1324

T

1325

"

1326

,

1327

1328

"

1329

C

1330

O

1331

D

1332

E

1333

"

1334

:

1335

1336

"

1337

A

1338

C

1339

T

1340

O

1341

R

1342

1343

I

1344

N

1345

P

1346

U

1347

T

1348

1349

\

1350

U

1351

2

1352

1

1353

9

1354

2

1355

1356

P

1357

R

1358

O

1359

X

1360

Y

1361

C

1362

O

1363

N

1364

F

1365

I

1366

G

1367

U

1368

R

1369

A

1370

T

1371

I

1372

O

1373

N

1374

:

1375

\

1376

N

1377

{

1378

1379

\

1380

"

1381

U

1382

S

1383

E

1384

A

1385

P

1386

I

1387

F

1388

Y

1389

P

1390

R

1391

O

1392

X

1393

Y

1394

\

1395

"

1396

:

1397

1398

F

1399

A

1400

L

1401

S

1402

E

1403

,

1404

1405

\

1406

"

1407

P

1408

R

1409

O

1410

X

1411

Y

1412

U

1413

R

1414

L

1415

S

1416

\

1417

"

1418

:

1419

1420

[

1421

\

1422

"

1423

H

1424

T

1425

T

1426

P

1427

:

1428

/

1429

/

1430

U

1431

S

1432

E

1433

R

1434

:

1435

P

1436

A

1437

S

1438

S

1439

@

1440

P

1441

R

1442

O

1443

X

1444

Y

1445

.

1446

G

1447

P

1448

R

1449

O

1450

X

1451

Y

1452

.

1453

N

1454

E

1455

T

1456

:

1457

1

1458

0

1459

0

1460

0

1461

\

1462

"

1463

]

1464

1465

}

1466

"

1467

}

1468

]

Code Examples

Why Use GProxy with Apify?

Apify is a web scraping and automation platform that runs cloud-based actors. While Apify offers its own proxy service, GProxy provides a cost-effective alternative with 10M+ residential IPs across 150+ countries. Using GProxy as an external proxy with Apify actors gives you better pricing, more IP diversity, and full control over your proxy infrastructure.

External Proxy Configuration

Apify actors built with Crawlee (formerly Apify SDK) support external proxy configuration through the ProxyConfiguration class. Pass GProxy's proxy URL as a custom proxy URL, and Crawlee will route all requests through it automatically.

Crawlee Integration

Crawlee is Apify's open-source web scraping library for Node.js. It supports CheerioCrawler (fast HTTP), PlaywrightCrawler (browser), and PuppeteerCrawler (Chrome). All three support external proxies through the proxyConfiguration option.

Cost Optimization

GProxy's pricing model can be more cost-effective than Apify's built-in proxies for high-volume scraping. Use GProxy datacenter proxies for non-sensitive targets and residential proxies for sites with strong anti-bot protection. This tiered approach optimizes your total scraping cost.

Session Management

Apify's session pool works with GProxy's sticky sessions. Maintain the same IP across multiple requests for login-protected scraping or multi-page navigation. Configure session max age and rotation frequency to balance between IP freshness and session continuity.

Scaling Best Practices

When scaling Apify actors with GProxy proxies, set appropriate concurrency limits based on your GProxy plan. Start with 10-20 concurrent connections and scale up. GProxy's infrastructure handles high concurrency, but respecting target site limits prevents unnecessary blocks.

Use Cases

[

{

"

T

I

T

L

E

"

:

"

L

A

R

G

E

-

S

C

A

L

E

W

E

B

S

C

R

A

P

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

R

U

N

A

P

I

F

Y

A

C

T

O

R

S

W

I

T

H

G

P

R

O

X

Y

'

S

M

A

S

I

V

E

R

E

S

I

D

E

N

T

I

A

L

P

O

L

F

O

R

E

L

I

A

B

L

E

,

L

A

R

G

E

-

S

C

A

L

E

D

A

T

A

E

X

T

R

A

C

T

I

O

N

.

"

}

,

{

"

T

I

T

L

E

"

:

"

E

-

C

O

M

E

R

C

E

M

O

N

I

T

O

R

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

R

A

C

K

P

R

I

C

E

S

A

N

D

S

T

O

C

K

L

E

V

E

L

S

A

C

R

O

S

R

E

T

A

I

L

E

R

S

U

S

I

N

G

E

O

-

T

A

R

G

E

T

E

D

P

R

O

X

I

E

S

F

O

R

L

O

C

A

L

I

Z

E

D

A

T

A

.

"

}

,

{

"

T

I

T

L

E

"

:

"

S

E

O

M

O

N

I

T

O

R

I

N

G

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

C

H

E

C

K

S

E

A

R

C

H

R

A

N

K

I

N

G

S

F

R

O

M

D

I

F

E

R

E

N

T

C

O

U

N

T

R

I

E

S

U

S

I

N

G

A

P

I

F

Y

A

C

T

O

R

S

W

I

T

H

G

P

R

O

X

Y

'

S

G

E

O

-

T

A

R

G

E

T

I

N

G

.

"

}

,

{

"

T

I

T

L

E

"

:

"

D

A

T

A

P

I

P

E

L

I

N

E

A

U

T

O

M

A

T

I

O

N

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

B

U

I

L

D

A

U

T

O

M

A

T

E

D

A

T

A

P

I

P

E

L

I

N

E

S

T

H

A

T

C

O

L

E

C

T

A

N

D

P

R

O

C

E

S

W

E

B

D

A

T

A

W

I

T

H

R

E

L

I

A

B

L

E

P

R

O

X

Y

R

O

T

A

T

I

O

N

.

"

}

]

Pro Tips

Use GProxy datacenter proxies for non-protected sites and residential for anti-bot-heavy targets. Set maxConcurrency based on your GProxy plan limits. Enable Crawlee's built-in session rotation for best IP diversity. Store GProxy credentials in Apify's key-value store, not hardcoded.